BUY IN PRINT WORLDWIDE! magpl.cc/store 


is 


Issue 73 September 2018 fp Ste ees | Seance org/magpl 


The official ene Pl an 


DESIGN, CREATE & DISTRIBUTE GAMES WITH RASPBERRY PI 


Ld Learn video game design LI Discover the latest tools LJ Join game jams & get involved 


4 AIY EDGE 
REVEALED! 


Google's new Al USB 
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Rediscover coding with the 
classic 1980s computer shows 
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a self-driving Raspberry Pi car Technology comes to the rescue 
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Discover the best robotics kits @ a maaoi.cc/store | |Press 


Raspberry Pi 3 B+ finds a new 
home 


Versatile enclosure for Raspberry Pi 3 B+ 


The new UCS-RPI Universal Case System is compatible with the recently launched 
Raspberry Pi model 3 B+. It has pre-milled side walls for easy access to the I/O and 
power inputs and is available in black or grey and two sizes. Complete with glue dot 
location posts to secure the single board computer to the case. 


For additional information call 0845 881 2222 or visit 
phoenixcontact.co.uk/UCS-RPI 
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INSPIRING INNOVATIONS 


Welcome 


WELCOME TO } 
THE OFFICIAL ~ -LE 
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aking video games is a rite of passage for 
most programmers. Children of all ages 
learn through play, and we can think of few 
better ways to spend the day than making our own 
video games. 

The Raspberry Pi is ideally suited to the creative 
side of video gaming. Its small, hackable nature 
makes the Pi a hands-on affair. 

Our favourite computer contains enough modern 
technology to run games like Minecraft while 
encouraging you to muck around with your own code. SUB SCRIBE 

Ever since the dawn of computing, there have 
been tools and techniques to help budding video — erenr ei 
game developers. Early coders had to make it up as SEE PAGE 34 FOR DETAILS on me A 
they went along (you still can), but there’s no need 
to feel so alone these days: there are a lot of tips for 
designing and making playable games. 


Above all else, the Raspberry Pi has a community. THIS MONTH: 
So you can share your games with other people and 
feedback hem. 
ee a 06 GOOGLE EDGE TPU ACCELERATOR 


We think gaming is an integral part of the | 
computing experience and is especially important Speed up Al neural networks running on a Raspberry Pi 


for younger and newer coders. So this month’s 24 MAKE GAMES WITH BASPBERBRY PI 


big feature is all about gaming: how to design and . . 
Design, develop, and share your own video games 
create your Own games, and share them with other 
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Let us know what you make! Keep your house safe and secure with Raspberry Pi 
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A simple function that has advanced uses 
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Make a sliding puzzle with Pygame 
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Shouting doesn't cut it with everyone 
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Schedule tasks on your Raspberry Pi 
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Make the screen move with your character 
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Measure environmental factors with Rust 
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Start your engines! 


A processor for Al Brand new challenge 


Some of the tools and techniques shown in The MagPi magazine are dangerous unless used with skill, experience, and appropriate personal protection equipment. While we 
attempt to guide the reader, ultimately you are responsible for your own safety and understanding the limits of yourself and your equipment. Children should be supervised. 
Raspberry Pi (Trading) Ltd does not accept responsibility for any injuries, damage to equipment, or costs incurred from projects, tutorials or suggestions in The MagPi 
magazine. Laws and regulations covering many of the topics in The MagPi magazine are different between countries, and are always subject to change. You are responsible 
for understanding the requirements in your jurisdiction and ensuring that you comply with them. Some manufacturers place limits on the use of their hardware which some 
projects or suggestions in The MagPi magazine may go beyond. It is your responsibility to understand the manufacturer's limits. 
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News 


AIY EDGE TPU 


ACCELERATOR 


Google announces TensorFlow Lite booster for Raspberry Pi 


Below The 
stylish Edge 
TPU Accelerator 
measures just 
65 x 30mm 


oogle has revealed the AIY 
Edge TPU Accelerator with 
support for Raspberry Pi. 
The small USB dongle attaches 

to a Raspberry Pi to increase the 
speed of running machine learning 
(ML) models. 
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These models use a previously 
trained neural network to create 
predictions, such as the next 
word in a sentence, or what object 
is in an image. The Edge TPU 
Accelerator makes it a whole lot 
faster to perform this prediction on 
a Raspberry Pi. 

The AIY Edge TPU Accelerator is 
designed to act as a neural network 
coprocessor for your Raspberry 
Pi 3 board, massively speeding 
up the process. 

These devices “represent our 
first steps towards expanding 
ATY into a platform for 
experimentation with on-device 
machine learning,” says Billy 
Rutledge, Google’s Director 
of ATY Projects. 

The AIY Edge TPU Accelerator 
is designed with mounting holes 


Above The tiny Google Edge TPU chip is 
designed to accelerate machine learning 
inferencing on devices like the Raspberry Pi 


The chip itself measures 
25mm square and runs machine 
learning models locally. The chip 
provides a vastly improved speed 
performance over using just a CPU, 
and at a low power cost. 

This first generation of the Edge 
TPU is designed to run predictions 
on pre-built models — it does not 


We know that performance- 
per-watt and performance- 
per-dollar are critical 


to attach to a Raspberry Pi board 
and uses a standard USB-C socket 
to connect. Google says that the 
device will be available “this fall 
in the US with other countries 

to follow.” The price is yet to be 
announced (magpi.cc/vROTII). 


Edge TPU 

The Google Edge TPU (Tensor 
Processing Unit) is anew 
purpose-built application-specific 
integrated circuit (ASIC) chip 
designed to accelerate TensorFlow 
Lite ML inferencing. 


support training. The models can 
be trained on desktop computers 
or much larger machines such as 
with Google Cloud. 

The presence of the TPU will 
enable a Raspberry Pi to execute 
previously trained neural network 
models much faster. 


TensorFlow Lite 

The Edge TPU is designed 

to work with TensorFlow 

Lite (magpi.cc/tflite), a new 
lightweight ML solution for mobile 
and embedded devices like the 
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AIY EDGE TPU 
ACCELERATOR 
SPECIFICATIONS 


ML accelerator: 
Google Edge TPU coprocessor 


Connector: 
USB Type-C* (data/power) 


“Compatible with Raspberry Pi boards 
at USB 2.0 speeds only 


Dimensions: 
65mm « 30mm 


Supported operating 
systems (on host CPU): 
Debian Linux, Android Things 


Supported frameworks: 
TensorFlow Lite 


Raspberry Pi. It features a set of 

core operators that have been fine- 

tuned for mobile devices. 
TensorFlow Lite supports 

a number of models, such as 

Inception V3 (used for detecting 

the dominant objects present 

in an image) and On Device 

Smart Reply (which is used 

to make smart replies to text 

messages — it first appeared on 

smartwatches). See here for a 

complete list of supported models: 

magpi.cc/tfmodels. Developers 

can also create their own models 

for TensorFlow Lite. 


High performance 

“We know that performance-per- 
watt and performance-per-dollar 
are critical benchmarks when 
processing neural networks within 
a small footprint,” says Billy. 

He explains: “The Edge TPU 
delivers both in a package that’s 
smaller than Lincoln’s head on 
a US penny. It can accelerate ML 
inferencing on a device or can 
pair with Google Cloud to create 
a full cloud-to-edge ML stack. In 
either configuration, by processing 
data directly on-device, a local 
ML accelerator preserves privacy, 
removes the need for persistent 
connections, reduces latency, and 
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AlY EDGE TPU ACCELERATOR 


al >| be a) (& Models - Chromium 


News 


hitps://aiyprojects. withgoogle.com 


VISION KIT VOICE KIT 


EDGE TPU 
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MODELS HELP 


allows for high performance using 
less power.” 

It’s early days for machine 
learning on devices like Raspberry 
Pi, and it will be exciting to 
see how small boards with 
advanced machine learning 
techniques can be used to solve 
real-world problems. 

Typical examples suggested 
by Billy include “maintaining 
equipment reliability, detecting 
quality control issues in product 


Above The Edge TPU ' 
Accelerator attaches to 

a Raspberry Pi via USB-C 

to improve machine 

learning inference 


FACE DETECTOR 


LEARN MORE 


DOG / CAT / HUMAN DETECTOR 


LEARN MORE 


DISH CLASSIFIER 


LEARN MORE 
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lines, measuring retail foot-traffic, 
[and] building adaptive automotive 
sensing systems.” In addition, 
we’re sure you’ ll all find plenty of 
unique uses for it. 

We’ re excited by the AIY Edge 
TPU Accelerator and can’t wait to 
take a look at it. More information 
can be found on the AITY Projects 
website: magpi.cc/edgetpu. 


Above Machine 
learning models 
for AIY kits are 
available on the AIY 
Projects website 
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ROARS INTO TOP GEAR 


Live-streamed races and 


self-righting cars make for Al 
thrills for Rosie Hattersley 


You can purchase entry to Formula Pi (Winter 2018) 
races via the PiBorg website (magpi.cc /oLKiFR). 
Entry is £37 and you don't need a robot or any other 
equipment (all race robots are provided by PiBorg, 
so everybody uses the same race design - all you 
need to supply is code). 

Along with your entry into the race series, you 
will receive in the post a Yeti-Lid to decorate. This 
is returned and attached to your car (so you can 
identify it in races). 

Take a look at the standard race code online at 
magpi.cc/hEJNsP. Entrants edit and update this 
code to win the race. Code is sent to Formula Pi 
via FTP and uploaded to a robot. Racers watch the 
race online with all the other competitors. 

“We have some amazing things lined up for 
the coming seasons,” says Tim Freeburn. “Please 
support the project and help make autonomous 
racing accessible to everyone!” 
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ormula Pi has been 

showing off its latest 

Raspberry Pi- powered 
self-driving robot cars ahead 
of a Kickstarter campaign that 
aims to take autonomous racing 
mainstream (see magpi.cc/jjcVzD). 

Unlike almost every other form 

of motorsport, this form of track 
racing isn’t prohibitively expensive 
for ordinary folk to get involved 
with. Formula Pi race director Tim 
Freeburn says competitors “do not 
require a large budget or their own 
robot to compete, with the cost of 
entry being about £37 (just $50).” 
Formula Pi even provides basic 
example code to get you started, 
which you can then adapt to 
improve racing performance. 


Competitive racing 
Formula Pi was showcased at the 
Raspberry Fields festival at the 
end of June, where cars with the 
new Raptor chassis were shown 
cruising round a broadly triangular 
track. While a great proof of 


Image credit Conor Ballard 


concept for autonomous driving, 
the smooth running demonstrated 
at Raspberry Fields only touched 
on the cars’ true abilities. To be 
really impressed you need to follow 
the Formula Pi competitive race 
season. Here, Al cars primed with 
team-customised code go head- 
to-head, avoiding collisions, taking 
the racing line, self-righting, and 
rebooting in a bid to complete the 
most laps in ten-minute heats. 

The MagPi got trackside access 
to a Formula Pi race at owner 
PiBorg’s Cambridge HQ, where 
we were able to watch three heats 
involving five second-generation 
YetiBorg AI cars. 

The races are recorded 
automatically using multiple 
cameras around the race track. 
Contestants around the world 
log in to watch the live-streamed 
event at formulapi.com, and post- 
race analysis can be viewed on 
YouTube at magpi.cc/KuYzfT. 

Live telemetry on each car is 
broadcast, along with its track 
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Competitors design custom 
Yeti-Lids for their Al cars 


Formula Pi 
racers must avoid 
collisions to rack 


with results akin to those in Crash 
Bandicoot.” For the 2018 season, 


position. And live commentary 
is provided by PiBorg developer 


it’s likely that some of PiBorg’s 
club cars will be employed as 


Claire Pollard (@thetuftii). Coder- 
owners join in with a live chat as 
the races take place. The overall 
result is a highly automated global 
race where code wins the day. 


Distinguishing marks 

Cars are distinguished by their 
different coloured lights and by 
the owner-designed ‘lids’ - metal 
tags that screw on to the otherwise 
identically specced vehicles. 
Custom code is sent to Formula Pi 
via FTP or, occasionally, an SD card 
in the post. 

PiBorg and Formula Pi director 
Tim Freeburn tells us that in the 
first competitive season of YetiBorg 
Al racing, entrants simply made 
their cars “as fast as possible, 


competitors had to add crash 
avoidance to their Raspberry Pi 
code. The effectiveness of this new 
rule was in full effect at the Formula 
Pi track in Earith, just outside 
Cambridge, where we witnessed 


Static obstacles, along with any up laps 
competitors that develop faults. 
At present, competitors can initiate 
a reboot code for ‘stalled’ cars. 
The middle of the race track 


already has nods to TV show 


A highly automated global 
race where code wins the day 


eroups of five cars dashing round 
the track at top speed and, mostly, 
avoiding each other. 

As with Formula One, the rules 
change from season to season. 
Presently, vehicles that crash or 
are entangled become obstacles for 
the other racers. For future races, 
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Commentator Claire Pollard 
introduces racers and 
checks their race stats 


Robot Wars, with mini versions 

of Matilda, Sir Killalot, and 

the turntable obstacle from Pi 
Wars (magpi.cc/ZWvFVH). In 
time, these props will become 
interactive — the windmill’s sails 
already turn — and may become 
additional obstacles. 


Faster cars 

Autonomous vehicles competing 
in the 2018 race season are twice 
the speed of the first generation of 
Formula Pi cars and can complete 

a lap in around 15 seconds. The 
yet-to-be-launched Raptor models 
are faster still, lapping in around 
seven seconds. Speed aside, what’s 
likely to really appeal are the 
customisable moulded chassis, 
designed by engineers at Rolls- 
Royce, which make the racers 
seem like ‘real’ cars. So if you want 
to get into competitive racing in 
which it’s your code that gives you 
the edge, Formula Pi looks like the 
high ‘oct-Al-ne’ way to go. 
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COMPUTER 
LITERACY 
ARCHIVE 


The 1980s was a golden era for home computing. 
Let’s explore it all over again, says Rosie Hattersley 


f you’ve ever wanted to know more about 
the history of British home computing, a 
whole treasure trove of interviews, TV shows, 


programming code, and photos has been assembled for 
your delectation and inspiration. The BBC has launched 


an archive of its Computer Literacy Project (CLP). 
This delightful archive of home computing and 


information technology (magpi.cc/nqHDem) includes 
all 146 TV programmes from a ten-year endeavour that 


began 36 years ago. 


The BBC Micro was a major 
influence on the creation 
of the Raspberry P1 


Interviews with heroes of technology and personal 


computing — including Microsoft co-founder Bill 
Gates, Apple’s Steve Jobs and Steve Wozniak, and 
Apricot’s Roger Foster — are all now accessible from 
the BBC’s Computer Literacy Project Archive. 
Launched back in 1982, the BBC’s Computer 
Literacy Project was intended to inspire and 


Back in 1982, the Acorn-built BBC Micro computer launched as a means 
of allowing home users to explore programming and coding. Homes 
and schools quickly bought into the personal computing revolution, with 
many of today’s most ardent computer fans citing the BBC Micro and its 
BASIC language as their first programming experience. 

You can easily install BBC BASIC on your Raspberry Pi. Open a Terminal 
and enter: 


sudo apt-get update && sudo apt-get upgrade 
sudo apt-get install brandy 


Then enter brandy at the command line to open the Brandy Basic V 
Interpreter. Note that you will need to use CAPS LOCK to enter BBC BASIC 
code, as you need to type every command in capitals. 
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The Computer Literacy 

Project Archive brings together 
all of the original 146 CLP shows, 
plus 121 related programmes 


FYE Computer Literacy Project 1980-1989 


encourage a whole generation of coders and 

home computing enthusiasts. The impetus for 

its launch was a critical Horizon documentary 

in 1978 that suggested a ‘lack of awareness and 
competitiveness’ in the UK that meant Britain was 
likely to miss out on the social and economic benefits 
of microelectronics. 

Such was the success of BBC Education’s CLP 
and the BBC Micro home computer (among others) 
that, says Hermann Hauser, co-founder of Acorn 
Computers, “Britain [was] the most computer 
literate nation on Earth at the time and with the BBC 
computer created a generation of UK programmers 
who have become leaders in their field.” 

The BBC Micro was a major influence on the 
creation of the Raspberry Pi, which was designed to 
capture the coding heyday of the 1980s and increase 
the number (and quality) of students applying to study 
computing at Cambridge University. 

Eben Upton, Raspberry Pi co-founder, told The 
Centre for Computing History (magpi.cc/EOMrxz): 
“The first computer I owned was a BBC Micro.” The 
initial idea for the Raspberry Pi arose from talking 
about redoing the BBC Micro (as a response to MIT 
planning an Apple II clone). 


Computing history 

The original BBC TV shows are bound to fascinate 
anyone investigating the UK personal computing 
evolution for the first time, while evoking nostalgia 
in those who remember the 1980s BBC Computer 
Pitercdevee TO|cer 
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The archive came about due to the difficulty for 
academics and technology historians to easily access 
treasures from the CLP. While the TV footage and 
interviews have been recovered, radio shows broadcast 
under the CLP banner appear to have been lost. 

Many of the TV shows make for interesting viewing 
from a present-day perspective. In May 1980, The 
Silicon Factor (magpi.cc/crbMPk) getting a paint- 
spraying robot in a car factory to memorise the actions 
involved in writing a name on a sheet of paper was 
eround-breaking. “The memory is recording every 
single unsteady movement of the pen,” explained 
presenter Bernard Falk before showing the robot 
accurately reproducing his writing. 

Meanwhile 1988’s Electric Avenue issued rather 
prescient warnings about data sharing and 
theft: magpi.cc/JziPxO. 

Mainly, however, the archive is about showing the 
possibilities and ideas of digital pioneers. As with 
the original CLP resources, BBC chief technology and 
product officer Matthew Postgate says the Computer 
Literacy Project Archive is “a unique resource for 
teaching and learning that will hopefully encourage 
a new generation of computer users.” 


Discover how to turn a Raspberry fe 


Pi into a functioning BBC Micro COMPUT] 
B 


(and lots of other old computer ee 
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systems) in issue 67 of & | . 
The MagPi: magpi.cc/67. 
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The BBC Micro project was 
instrumental in teaching 
computing in British schools. 
(Credit: Marcin Wichary, 
Wikimedia Commons) 


The simple way to mount your Pi! 


= £ 


¢ Industrial DIN rail mount 
- Open frame for better airflow 
- Integrated USB strain relief 


www.DINrPlate.com 
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RETURNS 


TO THE STAR 


Take your code to the International Space 
Station and beyond, urges Rosie Hattersley 


he European Astro 

Pi Challenge, an ESA 

Education project run in 
collaboration with the Raspberry 
Pi Foundation, is gearing up for its 
next mission. From 12 September 
until 26 October, Astro Pi will 
be accepting applications from 
space fans keen to impress ISS 
astronauts with their ideas and 
coding prowess. Part of the Astro 
Pi Challenge, Mission Space Lab 
is a four-phase experiment aimed 
squarely at secondary schools and 
older primary school pupils. 

The European Astro Pi 
Challenge is an annual science and 
programming challenge where 
student-written programs are 
run on the International Space 
Station. Last year it had 6800 


participants for its two missions: 
1500 for Mission Space Lab 

and 5300 for Mission Zero, the 
majority from secondary school. 
This year, the European Astro Pi 
Challenge aims to attract at least 
7500 participants. 


Get your code into space 
The aim of the European Astro 

Pi Challenge is to encourage 
schoolchildren to conduct 
scientific investigations in space 


by writing computer programs 
that will be run on Raspberry Pi 
computers aboard the ISS. 

For Mission Space Lab, teams 
first submit their experiment 
ideas — no code is required yet. 
The teams with the best ideas 
are then sent an Astro Pi kit 
including a Raspberry Pi with 
both an infrared camera anda 
Sense HAT, plus a microSD card 
and instructions on (optionally) 
3D-printing your own case. 


Astro P1 will be accepting 
applications from space fans 
keen to impress ISS astronauts 


12 | MdgPi September 2018 


Image credit: ESA 
(European Space Agency) 


Once your team’s code is 
approved, it is sent up to the 
International Space Station where 
your experiment is run on the 
ISS Astro Pi computers for three 
hours. Participating teams receive 
a download of the data for their 
experiment and a photo of where 
the ISS was when their experiment 
was taking place. Finally, students 
write up a Scientific report about 
the experiment they conducted. 

The teams submitting the 
ten best entries will receive a 
special certificate. 

The Astro Pi Challenge is open 
to entrants from ESA member and 
associate member states. For more 
details, visit astro-pi.org. 


Astronaut 
Tim Peake using a 
Raspberry Pi aboard 
the International 
Space Station 
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GREEN TOWER 


An aeroponics tower that uses a Raspberry Pi to grow some tasty veg 


> The tower has 
been five years 
in the making 
Water is pumped up to 
> The project misters inside the tower 
uses a custom to water the plants 
HAT board 


> It's what's 
knownasa 
‘vertical farm’ 


> Water is 
delivered to 
the plants 
as mist 


> The system 
repurposes a 
motor for door 
locks, a water To make the most use of 
pump from an vertical space, the veg grows 
RV, and more out of the side of the tower 


A Raspberry Pi controls 
the whole operation 
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Spiroponics <— 
Rev BOS” 
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Left The 
SpiroBoard, 
created by Chris 
for the project, 
monitors pH, 
electroconductivity, 
_ wv air temperature, 
= wae a and water 

ra . oe v. - Ree: temperature, as 
be = wellas controlling a 
motor for the pump 


e ETPERNE | Aa 
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Below It's a long 

way from soil and 

a watering can, but 

you should just 


De a ee i ; taste the results 


Ss healthy eating becomes compact, and low-cost aeroponic 


more and more popular, system that is easy to replicate.” 

a greater number of The idea came to him while 
people want to grow their own browsing through some 
vegetables. The problem is, not ‘particularly bad lettuce’ while 
everyone has a nice garden or shopping. “I had always been 
allotment to grow their own interested hydroponics,” Chris 
stuff - enter hydroponics and, explains. “The consistently poor 
specifically in Chris Johnson’s quality of the lettuce finally 


The consistently poor quality of 
the lettuce finally provided the 
push to begin the project 


case, aeroponics: the process provided the push to begin 

of growing plants in an air or the project.” 

mist environment. All the years of work have paid 
“For the last five years I have off and, as you can see overleaf, 

been designing and refining an Chris has been growing plenty of 

aeroponics tower system that is leafy green veg. 

particularly well suited to growing “A neighbour told me that 

leafy green vegetables,” Chris the kale was the best that they 

tells us. “The goal is to design a had ever had,” Chris says. “I 

computer-controlled, modular, personally am not a kale fan, 
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Below Who would 
have thought 

such an industrial 
setup could create 
something so tasty? 


LITTLE GREEN TOWER ‘Projects 


so I?ll have to take her word for This will also reduce the cost 

it. The green leaf lettuce is far to reproduce the system: “[It’s] 
Superior to what I was getting in printed with PETG, the same thing 
the grocery store. The best partis used to make two-litre drink 


that you pick leaves as you need bottles, since it is food-safe; same 

them and the rest of the plant as all the hoses and fittings. The 

just keeps on growing.” water pump is actually a standard 
Chris says that the main issue RV/caravan water pump.” 

still to overcome is algae growth A Raspberry Pi 3 powers the 

in the water. “I am working to system, with regular upgrades 

mitigate that with different plastic made to the Pi part of it. “I use 

and also different fertiliser. the webiopi web interface program 


To reduce algae, the plastic should 
be opaque so that the algae inside 
the system gets no light to grow 


Green-leaf vegetables need to provide the backbone for the 
copper and copper kills algae, so system and the control software is 
I will soon be testing a fertiliser written in Python,” reveals Chris. 
that contains the required trace “T use the pigpio library for the I?C 
amounts of copper. To reduce I/O and to control the waveform 


algae, the plastic should be opaque __— timing for a custom controller 
so that the algae inside the system board that I designed to work 


gets no light to grow. Standard with the Pi.” 

white filament, needed for its light You can find out more details 
reflectivity, is not opaque enough. on the Hackaday project page, 

I am looking to get a filament which Chris is in the process 
extruder so that I can make my of updating at the time of 

own more opaque filament.” writing: magpi.cc/RarKVA. 


Above After four 
weeks, lettuce 
can be seen 
growing well! 


Left It's more 
spaceship survival 
pod than English 
country garden, 
aesthetically 
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Projects 


SPACE 
WEATHER 
STATION 


ALEX SCHWARZ 


Alex Schwarz is an 
amateur radio enthusiast 
with a particular interest 
in space weather. 
magpi.cc/uldOgt 


The Pi helps 
with space 
weather 
predictions 


RF- 
Seismograph 
monitors up 
to six different 
bands 


It checks the 
NOAA space 
weather alert 
system 


24-hour 
monitoring is 
made possible 


Measurement 
graphics are 
uploaded to 

a web server 


Alex Schwarz uses the Raspberry Pi as part of an effort to better observe 
and predict the effects of space weather. David Crookes grabs an umbrella 


f you want to know what 
the weather is like, then 
some would suggest you 
look out of the window. But that 
only works if the weather you’re 
after is immediately outside. 
Should you want to know what’s 
happening elsewhere — in space, 
perhaps — then you’ have to get a 
little more technical. 

Alex Schwarz has done just 
that, developing a real-time space 
weather station which he now runs 
on a Raspberry Pi 3. It makes use of 
two well-established amateur radio 
software packages called the MDSR 
and RF-Seismograph, as well as 
some serious hardware including 
a huge antenna that can be many 
metres in height. These allow 
for real-time spectrum analysis 
and long-term propagation 


The Raspberry Pi 3 is fitted with 
a Fe-Pi Audio V1.4 24/16-bit 
sound card 


To simplify the setup of the 
unit, a Buck power regulator 
is implemented to reduce the 
13.8V to 5V for the Pi 


The LIF-2016 converter allows 
an existing transceiver to be 


used, ensuring the signal can be 
processed using the sound card 
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monitoring by detecting particular 
noise changes that point to 
specific happenings. 


Listen up 

To explain, propagation 
monitoring detects the behaviour 
of radio waves as they travel from 
one point to another in various 
parts of the atmosphere. As such, 
the idea is that the weather station 
is able to ‘listen in’ for changes 
in natural space phenomena such 
as the solar wind and the Earth’s 
magnetic field. 


——— ’ 


yanuneel 
AAA hey 


This is then interpreted by the Pi 
and its installed software, allowing 
a graphical representation of the 
weather to be noted. By constantly 
monitoring the input, it’s possible 
to view patterns and match them 
to phenomena. So far, the space 
weather station has picked up 
on a build-up of energy in the 
troposphere; at least two hours 
before the storm hit, it was possible 
to view the extent of the lightning 
Strikes. It has also detected 
propagation from meteorite trails. 
“Now we know how a meteorite 
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SPACE WEATHER STATION 


RUNNING THE WEATHER STATION 


looks on the RF-Seismograph and 
it will enable us to spot more, even 
during the day,” Alex says. 

It really is an impressive feat, 
especially considering Alex and his 
fellow amateur radio enthusiasts 
wrote the RF-Seismograph 
software themselves. “We 
believe it has great potential to 
increase the understanding of the 
ionosphere [the ionised part of 


we discovered the software is also 
perfect to measure and show how 
short-wave radio propagation 
changes over time.” 


Sounding off 

The Raspberry Pi has certainly 
come to the rescue. Initially, the 
software had been running on 
Windows and Linux, but Alex 
and his friends wanted a way of 


It was originally designed 


to measure the 


Earth’s upper atmosphere] and 
how it protects life on this planet,” 
Alex tells us. “It was originally 
designed to measure the solar 
eclipse last year, but in the process 


| duration of storm | all monitored bands are open 
+—_________->+4______ 


Above This image shows the results of a 
thunderstorm as seen through the space 
weather centre, with the lightning spikes 
clearly visible 
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solar eclipse 


lowering costs. “The Raspberry Pi 

3 is fast enough and so we decided 
to move all our software over to 
Raspbian,” Alex says of the switch. 
“The RF-Seismograph runs a little 
slowly on the Pi so there’s room for 
improvement, but it’s a lot simpler 
and cost-effective in comparison to 
PCs. The OS is also stable, it’s easy 
to install, and the add-on hardware 
looks classy.” 

The hardware for this project 
included a sound card with stereo 
line input for picking up the sound 
waves that are created in the 
receiver. By scanning the receiver 
across six different short-wave 


\ Solar Radiation 
\ Sprite mn \ 
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bands, changes can be monitored 
and identified. In order to get the 
raw signal from the receiver, the 
LIF-2016 converts radio waves to 
sound waves that the audio card can 
process. The higher the quality of 
the sound card input, they figured, 
the better the results for the 
received and demodulated signal. 
For convenience, a seven-inch 
touchscreen was also added and 
the whole setup was connected to 
the transceiver — the device that 
connects to a large shortwave 
antenna and picks up the signal for 
the Pi to process. “The software is 
capable of sharing this information 
with the world by including an 
FTP server that uploads every ten 
minutes to the web,” Alex adds. 
“So that is how we keep our website 
automatically current. It’s certainly 
been worthwhile.” 
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Above A diagram 
showing the 
different layers of 
Earth's atmosphere 
detectable 

by the space 
weather station 
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Within the portable case are 
Eneloop batteries powering the Pi, 
camera, and thermal printer - they 
deliver a constant voltage 


The camera's rudimentary output 
is limited by the doodle data of 
Google's Quick, Draw! project 


> Draw This 
uses a neural 
network to 
recognise 
objects 


>» Images are 
matched with 
doodles from 
Quick, Draw! 


>» The doodles 
are printed like 
on a Polaroid 
camera 


> The Quick, 
Draw! dataset 
costs nothing 
to download 


> The entire 
dataset takes 
up just 5GB 
of space 


The Raspberry Pi 3 is wired 
up to a shutter button as 
well as to a status LED 


Dan Macnish wants to help people overcome fears about deep learning 
and artificial intelligence by using a camera that turns photos into 
cartoons. David Crookes strikes a pose 


e all know how cameras 

work. You line up your 

shot, fiddle with the 
focus, set the shutter speed, and - 
flash! - you get a perfect image of 
whatever is in front of you. With 
Dan Macnish’s camera, however, 
the process and results are a little 
different. Instead of outputting a 
faithful photograph, it attempts 
to turn what it sees into a cartoon 
doodle, instantly spitting it out 
on to thermal paper like a quirky 
Polaroid picture. 

To do this, it makes use of two 
key components: a neural network 
and the dataset produced by 
Google’s online game Quick, Draw! 
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(quickdraw.withgoogle.com). 
The game is similar to Pictionary 
in that it suggests an object to 
sketch, with the twist being that it 
then uses AI to predict what you’re 
attempting to scribble. The result 
has been more than 50 million 
doodles, and Dan’s device seeks to 
match one of them with whatever 
the neural network reckons has 
just been snapped. 

It’s all rather eye-catching. “I 
got the idea while experimenting 
with some of the amazing open 
source research into neural 
networks,” Dan tells us. “There are 
some great projects coming out of 
this research, but many of them 


are focused on neural networks 
themselves, rather than simple 
applications for these networks. 
So my project originated as a 
super-fun, simple application for 
this research, to be enjoyed by all 
sorts of different people — not just 
engineers and developers.” 


Cartoon camera 

As such, Dan was keen to keep 
things simple, fun, and whimsical, 
and he soon got down to work. He 
began with some basic sketches 
and ideas focusing mainly on what 
the user experience would be. 
“Through these initial sketches, I 
set on the idea of a Polaroid camera 
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that draws cartoons, without ever 
showing the original image,” he 
says. “I particularly focused on 
the emotions and feelings that 
people might have: their surprise 
when seeing a cartoon and the 
excitement of not knowing what it 
would look like.” 

At the same time, he began 
prototyping the software using 
Python and Jupyter Notebook on 


My project originated as a 
| Super-fun, simple application 


his laptop. He ran a pre-trained 
network over a few photographs 
before manually browsing the 
Quick, Draw! dataset and hand- 
selecting images which he then 
copied and pasted together in 
Paint. “These quick prototypes 
led me to flesh out the software 
and I moved on to an integrated 
development environment (IDE). 
Once | was getting good results on 
the laptop, I transitioned the code 
to the Raspberry Pi.” 


Pi 3 running Raspbian Stretch 
on a16GB card, with a v2 
Camera Module, outputting toa 
thermal printer, all housed ina 
simple cardboard casing. When 
an attached shutter button is 
pressed, the software interprets 
what it sees as one of 345 
doodles and outputs them. 

“The neural network I used can 
only recognise a small fraction of 


the categories in the Quick, Draw! 
dataset,” Dan explains. “So there 
are still many possibilities for 
using this dataset that have not 
yet been imagined.” 

Even so, the response has been 
hugely positive. “People love 
the concept and it’s great seeing 
their reactions to some of the 
funny cartoons that appear,” he 
says. “One of the most surprising 
things is that even when the 
camera prints something 


2 Some results are stranger than others. Dan's foodina 


Japanese cafe was turned into an American hotdog, while some 
selfies have replaced humans with dogs 


2Low Dan used some efficient Python code released by Google 
to interface with the individual drawings 


Pi-cture this 


At the heart of the device is an 


completely incorrect, people often 
interpret the cartoon in a way that 
makes it seem correct after all. It’s 


internet-connected Raspberry 


quite entertaining.” 


>STEP-O1 

Press the button 

Although there is a lens at the front of the 
casing (a v2 Camera Module), there is no 
viewfinder around the back. You simply 
power up, aim, and press the shutter 
button on top. 
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>STEP-O 
Time for processing 

When the shutter button is pressed, the 
status LED lights for two to three seconds 

as the Raspberry Pi processes the image. 
The Quick, Draw! dataset covers hundreds of 
objects, from forks to faces, beards to bears. 


Printing a picture 

Dan says the lack of a screen and the 
inclusion of a thermal printer enhances 
the experience. “There is a fantastic 
feeling of anticipation as the image slowly 
appears from the printer,” he says. 
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Hoverbot cost 
only around 
$250 to build 


It can run for 
4+ hoursona 
battery charge 


A60-LED strip 
is used for 
illumination 


Hoverbot 
features a 
webcam and 
speaker 


Code and build 
details are at 
magpli.cc/ 
PMnvoOi 


<3 


ISABELLE SIMOVA 


Isabelle enjoys tinkering with 
electronics, but this is the first 
project she has open-sourced. 
magpi.cc/CDEbOq 


An IKEA tabletop; other 
table sections were 
upcycled for the body 


An LED strip provides 
animated lighting effects 


Hoverboard-sourced 
wheels are supplemented 
by castors 


HOVERBO! 


A robot made from a hoverboard and an old table? 
Nicola King investigates the fascinating world of upcycled bots... 


hile countless Raspberry 

Pi robots have been 

created, most of them 

are on the small side. Hoverbot, 

however, bucks this trend and 

comprises upcycled parts including a 

hoverboard and an IKEA table. 
Maker Isabelle Simova explains 

that she did not set out to builda 

robot of a particular size, but first 

asked herself a number of questions 

about what makes a useful robot. 

“T considered a couple of relevant 

scenarios like moving goods around 

a Store, picking up items at home, 

or watering plants. For a robot to 

accomplish those tasks, at the very 

least it needs to run for a reasonable 

amount of time (at least a few hours) 
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and be strong enough to carry a good 
amount of weight (10 kg or more).” 

So, Hoverbot was born, a large 
robot that is equipped with sonar 
sensors for obstacle detection and 
is powerful and sturdy enough to 
transport heavy items. “Hoverbot is 
strong enough to carry me around,” 
says Isabelle, “though I wouldn’t 
recommend it to other people for 
safety reasons!” 


Recycle, repurpose, 
regenerate 

Taking around three months to 
build, Hoverbot is essentially 

an upcycled machine, a concept 
that was important to Isabelle. 
“When you repurpose consumer 


goods you are not only leveraging 
the economies of scale that 

make otherwise expensive items 
affordable, you are also leveraging 
and extending work that has already 
been done by someone else,” she 
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Above A web dashboard enables remote 
control of Hoverbot, including text to 
speech to make it talk 
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says, adding that “upcycling can 

be a great forcing function for 
productivity as well. It can give you 
a concrete starting point in what is 
sometimes an intimidatingly large 
search space .... When you upcycle 
something you already have, you are 
putting something to use that might 
otherwise end up in a landfill.” 
Clearly a point that our consumer- 
driven societies need to take on 
board, and something that a lot of 
makers and hackers generally are 
already aware of. 


Trial and error 
A disassembled hoverboard met 
the requirements of the project, 
and at a fairly low cost. Isabelle 
met various challenges along the 
way, including reprogramming the 
motor controller, which required 
her to write firmware without any 
manufacturer documentation. 
“The process involved some 
trial and error and I accidentally 
let the magic smoke out of two 
hoverboard motor controllers.” 
Having used the Raspberry Pi in 
other projects, she was confident 
that it was up to the job: “With 
a Raspberry Pi you can ... both 


INNER WORKINGS OF HOV 
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The Hoverbot in autonomous mode, using 


its sonar sensors to avoid obstacles 


easily interface with devices over 
GPIO and run software written in 
high-level programming languages 
like JavaScript and Python. With 
Node.js on the Raspberry Pi, | 

was able to write all the Hoverbot 
application logic in JavaScript and 


HOVERBOT 


Projects 


and extending the robot’s 
capabilities, as she explains: “Its 
current incarnation doesn’t do 
much beyond driving around and 
avoiding obstacles, so it does 
need a bit more intelligence to 
accomplish useful tasks.” 


Hoverbot 1s strong enough to carry me 
around, though I wouldnt recommend 
it to other people for safety reasons 


leverage existing Node.js modules 
for serial and SPI communication.” 

Isabelle tells us she will continue 
to tweak the Hoverbot, improving 
the motor controller firmware, 


E 


— 


>STEP-02 


It’s truly inspiring to see 
what can be built with a dose of 
ingenuity and just a few items, 
some of which may otherwise have 
been destined for the bin! 


>STEP-03 
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DESIGN, CREATE, AND DISTRIBUTE YOUR OWN GAMES WITH OUR 
GUIDE TO EASY DEVELOPMENT TOOLS FOR THE RASPBERRY PI 


K.G. is a developer, software 
preservationist and avid player 


of obscure indie games. They're 
currently developing audio 


systems for Deck of Bards’ 


Codename Caerus. 
* * * twitter.com/kgorphanides 
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t’s easier than ever 

to make and publish 

your Own games, and 

the Raspberry Pi is a perfect 
development platform, thanks toa 
wide range of tools and a hardware 
spec that encourages efficient, 
widely compatible design. 

If you’re new to programming, 
there are plenty of development 
environments that are easy to 
learn as you go, thanks to clear 
interfaces and copious tutorials. 
Whether you want to make an 
adventure game, a shoot-’em-up 
ora platformer, we’ll help you 
find the tools you need. 

Some of the most innovative 
games and interactive experiences 
combine or defy established 
genres to create something 
entirely new. 
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THINK SMALL 


A successful game project is the 
one you finish. If you’re a solo 
developer working on your first 
or second game, it’s probably a 
mistake to set out to make a vast 
open-world RPG. 

There’s a huge audience for 
tiny games, and the process of 
developing a small but perfectly 
formed gem can teach you a lot 
about tight design, efficiency, and 
good development practices. 

Best of all, when you’ve finished 
your game, you can Share it with 
the world before going to work on 
your next fantastic project. 


PLAN YOUR DESIGN 


The first stages of game 
development don’t require any 
tech at all: your brain and some 


Editing “Fight the ghast” 


a 


way of taking notes are basically all 
you’re going to need. 

What do you want your game to 
do? Do you want to tell a specific 
story, create a world for the player 
to explore, or present a puzzle or 
physical challenge to be overcome? 
Which development tools and 
game Styles are most appropriate 
for your project? 

What skills do you have and 
what resources are available? 

Are there any particular areas of 
design and development that you 
want to try out? 

If you’re particularly comfortable 
with your ability as a 2D artist, 
then a visual novel could be 
perfect. Writers and storytellers 
can try their hand at text-based or 
simply illustrated narrative games, 
while keen programmers could 


Left: Learning 
how to work with 
simple game 
development 
tools can help 
you learn the 
fundamentals of 
programming, 
with a concrete 
goal at the end 
of it all 
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Far left: You 
can use game 
creation tools 
to write deeply 
personal stories 
for a specific 
audience... 


An icy crust has settled over the snow that leads to a narrow path through the 


Left: ...Or a fun, 
throwaway 
tribute to the 
classics, just to 


evergreen forest, but it's clear that people have walked this way recently. 


The snow underfoot thins as you pass beneath the trees, and a thick floor of fallen 


leaves and soft pine needles protrudes in patches where the snow and ice thins. 


The trail is little wider than an animal track. 


You can turn k or keep walkin 


Current mode: wholesome 


Switch to unwhol some mode 


na i For most games, you'll need a 
plot or objective (even if it’s as 


If you want to experiment with 
=. programming and development 
“but don’t know where to start, 

» then a ‘fantasy console’ such as 
PICO-8 gives you a development 
environment with a complete but 
helpfully restricted set of features, 
so you can focus on making your 
game without being overwhelmed. 


Eg ' focus on logic or action games PUELISHING Game jams take place both on- = fi 
ih e e e e e e . ial 
_ | illustrated with Creative Commons YOR GAMES and offline. Some are competitive, , © 
» © image assets. Once you’ve finished your game, with plaudits or even prizes for i.e 

| a 


it’s easy to publish it, whether 
for free, as pay-what-you-want 


GAME JAMS 


If you need a bit of inspiration 
or motivation, try a game jam. 
These events invite participants 
to produce a game on a specified 
theme, sometimes using a 
particular game engine, within 
a set period of time. 


INDIE GAME JAMS LIST 


learn how they 
were made 


the highest rated titles, but most FP. 
are just an opportunity to test your 


- simple as ‘rescue the kidnapped donorware, or for a fixed price. skills, make something cool, and . 
- king’, ‘collect the blue spheres to Two of the best platforms for talk to other people who share your = 
= replenish the planet’s soul’, or independent games publishing are development interests. = | 
“2 ‘defend the bug-eyed monsters Itch.io and GameJolt.com. Both of Offline game jams in particular "sg 
” . from ahuman invasion’), probably __ these popular digital stores let you | encourage people to work together, : "/ 
= giving artists, musicians, writers, 
: ¥ - If Viele need q bit of and programmers a)chance to 
. combine their talents to create a 
re inspiration or motivation, something more sophisticated —* 
a than they could alone. Many online 
, try Q game jam ' ' jams encourage the same kind of 
: teamwork, using communication 
- some graphics and sound effects, publish games free of charge and, platforms such as Discord to get 
” t and some programming to hold if users pay for your game, take people talking. 
)_. everything together and turn your a small percentage of that fee to Fans of different game engines 
F idea into a functional game. cover their costs. or genres hold regular dedicated ". - -. ae 


jams or contests. Notable annual 
events include IFComp for text 
games, make-a-game-in-a- 
weekend jam Ludum Dare, and 
the Global Game Jam at physical 
locations around the world. You 
can also find lists of game jams on 
Itch and Game Jolt. 


AME AI 


ITCH.IO JAMS 


J "si : 5 indiegamejams.com itch.io/jams 
GLOBAL GAME JAM GAME JOLT JAMS 
globalgamejam.org jams.gamejolt.com 
LUDUM DARE IFCOMP 
Every year, there are hundreds of game jams: free community challenges where ldjam.com ifcomp.org =~ /_ 


people come together to make games within a set theme and time limit. 
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YOU WILL-NEED 


PICO-8 ($14.99) 


magpi.cc/NIBFUe “Hi 


ICO-8 is a fantasy 
console - a tiny virtual 
machine that pretends 
to be an 8-bit games console 
or home computer. It uses an 
implementation of the Lua 
programming language with 
special libraries and features to 
make it easier to make games. 

PICO-8 isn’t open source and 
you’ll have to pay for it, but 
$14.99 gets you perpetual, DRM- 
free updates and you can sell or 
give away the games you make 
without restriction. 

Some of the most important 
decisions in game design are 
about what your game won’t 
do. Narrowing your choices and 
options through mechanical 
means is an excellent way of doing 
this. PICO-8’s fantasy console 
conceit means that you only have 
to deal with a 16-colour display, 
six control inputs, four audio 
channels, and a maximum 32kB 
compiled game size. 

Once you’ve created a game, 
you can Save and distribute it as 
a virtual cartridge that can be 
packaged as a Standalone game 
or played via a web browser. You 
can also import other people’s 
cartridges to take a look at 
their code. 
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STEP DOWNLOAD 


OF AND ALUN 
FICO-& 

Lexaloffle fulfils PICO-8 orders 

via the Humble store. After 

buying it, you’ll be emailed a 

link to download the software 

and associate it with your 

lexaloffle.com account. It’s worth 

registering on the site to get 

support, distribute your games, 

and engage with the community. 
For the Pi, you should download 

the Raspberry Pi version of PICO-8 


from Humble or Lexaloffle. 
Expand the zip file wherever you 
like, go to that directory, and run 
the app from the File Manager 

or the command line. It’1] 
automatically create some hidden 
directories to store its game files 
the first time you run it. 


| | 
| a | 
| [os te | a ee 
fea [ (iQ 


The fantasy console 
opens at the main 
PICO-8 screen. Like the main 
interface of early home computers 
such as the C64 and Spectrum, this 
is where you can load programs 
and run simple command strings 
in Lua. 

PICO-8 comes with a demo 
pack, which we’ll install and take 
a look at... 


INSTALL_DEMOS 
CD DEMOS 
LS 


To play any of the listed games 
and demos, use the LOAD and RUN 
commands. For instance, to play 
The Adventures of Jelpi: 


STEP USING PICO-& 


LOAD JELPI 
RUN 


...and then press ESC when 
you're ready to quit. 

Many other game cartridges are 
available to download online, both 
as paid and free games, but make 
sure you put them in Pico-8’s 
working directory. On the Pi, 
that’s: ~/.lexaloffle/pico-8/carts. 
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STEP THE CODING 
INTERFACE 


To get from the main 
screen to PICO-8’s game creation 
tools, all you have to do is press 

ESC. If you’ve loaded a game into 


ARE ACTORCH. 4) 
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Ay EDNEE 
At the top right, 

a bank of icons lets you shift 
between edits. To the right 

of the text editor - with an icon 
that’s either a pointy-toothed 
mammal or a butterfly - is the 
Sprite editor. 

Each sprite is 8x8 pixels in size 
and can take full advantage of the 
console’s 16-colour palette. You 
can create up to 128 sprites, witha 
further 128 that can optionally be 
stored in memory otherwise used 
for the game’s world map. Sprites 
are Shown in numbered banks 
towards the bottom of the screen, 
which you can switch between using 
the mouse. 


STEP MAP EDITOR 


=, The map editor works 

a similarly to the sprite 
editor, but with a much larger area. 
PICO-8’s default level map area 
measures 12832, although you can 
expand that to 128x64 if you use the 
shared space that could otherwise 
house extra sprites. 

Rather than drawing individual 
pixels, here you’ll use the draw tool to 
place sprites as scenery, background 
objects, and decorations in the spaces 
the player will be exploring. Buttons 


memory, you’ll be able to browse its 
code. Otherwise, you’ll be presented 
with a blank input screen. 

Although it looks basic, PICO-8’s 
editor has far more features than 
the 8-bit computers that inspired it. 
Most important of these are syntax 
highlighting and cut, paste, and 
selection features using the mouse 
or keyboard, as you would in any 
modern GUI editor. You can also 
search your code by hitting CTRL+F. 

At the top right, a number shows 
which tab of the text editor you’re 
on, while a plus sign next to it allows 
you to create new tabs within the 
Same project, for example to keep 


If you want to create an animation 


cycle for an ‘actor’ (a character or 
moving object in the game), just 


place all the sprites in that sequence 


one after the other and PICO-8’s 
code routines will easily be able to 


show them all in order - all you have 


to do is specify the initial sprite’s 
numbered position in the buffer 
and the number of frames in its 
animation cycle. 

Editing tools allow you to draw, 
select, copy, paste, move (pan), 
and flood-fill parts of your sprite. 
You can flip, vertically flip, and 
rotate sprites using the F, V, andR 
keys respectively. 

There are eight sprite flags in 
the form of coloured circles just 
above the sprite number marker. 
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at the top right allow you to switch 
between having the level occupy the 
full screen or partly obscuring it by 
showing the sprite library. 


different code elements manageably i 
grouped together. When you run your 7 
program, it’ll treat alltabsasasingle = 


program, running the code in them 8 

in order. oF 
Icons at the top right let you - 

switch from the editor to PICO-8’s "" 

other integrated game-building aot 

tools. The text editor is signified "s | 

by a pair of brackets. i 


While PICO-8’s built-in editor is : a 
surprisingly sophisticated, youmay «=~ 
find a standard text editor more 


capable and easier on the eyes. A. 
Fortunately, you can open and edit a 

.p8 files in anything from Leafpad aes 
to Vim. . 
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Each of these can be set to on or 

off, and can be assigned to different 
characteristics using the code editor, 
such as whether a given sprite will 
be solid or not. 

Above these are brush size and 
zoom adjustment bars, which are 
handy if you’re working on sets of 
sprites that will make up tiles of a 
larger piece. 


Depending on your game’s style 
and scope, you may need to pan 
around the level quite a bit — the 
SPACE key activates the click-and- 
drag to pan tool, and you can zoom 
in and out using your mouse’s scroll 
wheel or the < and > keys. 

The location of sprites in the level 
is defined using x and y co-ordinates 
displayed in the bottom toolbar. You’ll 
be able to place interactive characters 
and objects in the level by specifying 
the co-ordinates at which they should 
appear in your code. 


Zs lo 
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STEP SFx EDITOR 
s The built-in SFX (sound 
effects) editor makes 
it easy to create a rich soundtrack 
of 8-bit music and effects for your 


409 SPD 1b LooP oo oo 
CCTHEED BERBER aAs 
alll BSP 
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STEP MUSIC 
OD Eniton 


The music editor 
oes allows you to assemble your SFX 

r tracks to play simultaneously, 
consecutively, or in a specified loop 
to build up your soundtrack. You 
can have up to four SFX playing 
simultaneously. By default, each 


STEP 1 ii 


> OB tu mie 8’s minimal 


Lua-based API makes for a clear 
and consistent programming 
experience. The official manual’s 
plain text formatting is a little 
unwelcoming, but it provides plenty 
of examples of how to use its more 
complex features. 

However, to get to grips with the 
basics of your new fantasy console, 
the best thing to do is look through 


PICO-8 MANUAL 
magpi.cc/uXMVws 


SCUMM-8 
magpi.cc/LaGTWu 


raspberrypi.org/magpi 


SECTORDUB’S PICO-8 FANZINE 
sectordub.itch.io 


PLATFORM GAME DEMO IN 100 LINES 
magpi.cc/nWFCrT 


MAKE YOUR OWN VIDEO GAMES 


game. Any SFX track you make 
can be called in your game’s code 
when an event occurs, or pulled 
into the music editor to create 
backing themes. 

For sound effects, you’ll mostly 
want an array of blips, beeps, and 
crashes. These are easily created 
using pitch editor mode. This lets 
you draw the shape of your music or 
sound, using a range of instrument 
voices inspired by classic consoles. 

Press TAB or select the 
appropriate icon at the top left 
of the screen to switch to tracker 
mode, which gives you individual 


pattern will move on to the next 
unless it hits a loop end marker 
— a loop begin marker allows you 
to determine where the loop will 
return to. 

You can have up to 64 of these 
patterns, and use the music() 
function to start and stop them 
in your game’s code. 
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WALA Te 
PICK-UP PUSH « 


OPEN 
CLOSE LOGK-AT PULL 


GIVE TALK-To USE © 


the code of the supplied demo 
games, copy it, and then modify it 
to create your own first games. 


RESOURCES FOR PICO cownonopico-s canes 


itch.io/ games/tag-pico-8 
gamejolt.com/tag/pico8 
magpi.cc/qkBOds 


FEATURES OF PICO-8 LUA 
pico-8.wikia.com/wiki/Lua 


control over each note, making 

it better for more complex music 
composition and editing the effects 
you created in pitch mode. 

In tracker mode, you can also use 
your computer keyboard to play in 
notes one at a time. Remember that 
inserting the same note repeatedly 
will result in a single long note at 
that pitch - to create a silent rest, 
just reduce the volume of a given 
note to oO. 

Each SFX track can have a 
maximum of 32 notes, and 
there’s room to store up to 64 
individual SFX. 
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If you want to make a specific 
kind of game for the PICO-8, such 
as a shooter, platform game, or even 
a point-and-click adventure, there 
are dedicated game engines and 
demos for the system that provide 
all the code you’ll need to make 
different types of game, which you 
can then work with and customise 
for your own purposes. Paul 
‘Liquidream’ Nicholas’s SCUMM-8 
graphic adventure game engine is 
particularly impressive. 
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4. Arte SORE 


ae LEING 


Sto 


arrative games range 

from simple interactive 

storybooks to puzzle-filled 
adventure games and combat- 
packed RPGs. We’re going to look 
at two of our favourite tools for 
making story-based gaming worlds 
in very different styles. 


WEARUING A 
NARRATIVE 


WITH THINE 


Twine is a favourite development 
tool among game writers keen to 
show off their narrative chops. 

It lends itself to interactive 


( Bitsy = 
¢ CS © localhost 


Hy’ Bitsy In the shadow of the city 


a bile color 


= dialo 


4@ sprite color ¥ PF dialog: ra list 


Te a 


stories and choose-your-own- 
adventure style games, but has 

a scripting language powerful 
enough to support fully fledged 
RPGs and strategy games. Both 
Twine and the games it makes run 
in a browser. 

Your game is built up of 
passages of text, which are 
shown on an overview screen as 
little interlinked cards. Because 
it supports branching dialogue 
and plot paths, Twine is a great 
tool for mapping out the path 
of narrative games destined for 
other platforms. 


Bitsy - Chromium 


(+ eam A text effects 


VY conditiona 


Hello, small cat. 


The first thing to do 


= ene when starting a Bitsy 
- . project is name your 
game in the title field 


Each room in your game has a 16x16 grid that 
you can populate with characters and scenery. 
We've made ours black and white, but you can 
= 9, fa use any three colours in your game 
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TWINE HARLOWE MANUAL 
twine2.neocities.org 


BITSY-NWJS 
magpi.cc/ WHCsGD 


BITSY TUTORIAL 


magpi.cc/QxmzMO 7 ; 


Its most basic function is the 


[ [link] ] command. If you put any _ 


string of text between two sets of 


o° Ea 


& 


Hello, small cat. 


You draw all characters, 
objects, and scenery as small 
8x8 images. The sprite class, 

for interactive characters 
and items, can have dialogue 
boxes to communicate with 
the player 


1ESs 


| 
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MAKE YOUR OWN VIDEO GAMES 


There's no standalone Twine desktop client for the Raspberry Pi, but 
a local version of the engine called TwineJS is maintained by original 


creator Chris Klimas. 
Open a Terminal window and type the following commands: 


curl -sL deb.nodesource.com/setup 8.x | sudo -E bash - 
sudo apt install -y nodejs 

git clone github.com/klembot/twinejs.git 

cd twinejs 

npm install (to install Twine’s dependencies) 

npm start (to start Twine on a local server) 


My name is Nate | Access Twine from Chromium by going to http: //localhost:8000. 
Tam a snake Run npm start from your twinejs directory every time you want to 
work on your game. 


Bitsy games are published as HTML : ; : : : 
files, which you can upload to a user community, with regular You get an 8x8 pixel grid with 


Sige ela uitel eee Mo te game jams to inspire to you tryout _ two frames of animation to draw i. 


your skills. four key object types: a 
i. square brackets [[like this] ], Bitsy is self-consciously simple, 
Twine will automatically create which makes it ideal for anyone 


ry a new passage with that name who’d rather tell stories and Your game’s 

r and display a link to it from your build worlds than immediately playable character 
ce current passage. dive into coding. It’s particularly 
“i good for linear and exploration- Scenery that can be 
TINY GAME DESIGN based stories or object collection either solid walls or 
ie EITS¥ games. You can implement simple decorative items that ae ge os 
Bitsy is an easy-to-use tool for puzzles using its conditional can be walked over 


F | = creating three-colour pixel art dialogue options and even expand 
_h| adventures in your browser, either _ Bitsy’s core functions using your Interactive scenery and 
ee OL “.  on- or offline. First released in own or other people’s extensions non-player characters 
a early 2017, it already has a huge and hacks. 
La Objects that can be 
PEE ee ae Peg ee a ee ee rs picked up 
RUMBITSY OR THE PIE +s: 
=e 
While Bitsy normally runs in a browser directly from the creator's You can use these objects to 


website, there's an offline version that's perfect for Pi development design and populate rooms ona 

projects. It still works via a browser, but is fully functional without an ects 16x16 grid, with small snippets of 

internet connection. Install and build it with these commands: decision-based dialogue associated with sprites and 
narrative items. A tools button next to your 

. | Be ) | games, Twine's eee 

curl -sL deb.nodesource.com/setup_8.x | sudo -E bash - Fes game’s title at the top of the screen 

sudo apt install -y nodejs screen can reveals more options including the 

git clone github. com/ztiromoritz/bitsy-nwjs.git show you how exits window, where you can join 

edabicee eae each passage t iaayark t 

cd bitsy-nwjs Sie your rooms together to create a 

npm install to all the others world for the player to explore. 


npm run build 


The build can take quite a while, even on a Pi 3 B+, making this an ideal 
time to go and get a cup of tea. With that done, launch your offline Bitsy 
server from its directory whenever you want to use it, by typing: 


npm run serve 


—_—" You can access it in your browser by going to http: //Localhost:8000 
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EIGHT MORE FASCINATING GAME-MAKING TOOLS FOR THE PI 


wide range of game 
engines, integrated 
development 
environments, and markup 
languages designed for game 
development work brilliantly on 
the Pi. We’ve highlighted eight of 
the most interesting, with pointers 


on getting them up and running. 
a 
LOVE 


love2d.org 


If you've got to grips with PICO-8 and want something 
a little more flexible, you might be looking for LOVE. 
This more advanced Lua-based game engine has 
been used to make some quite sophisticated titles 
and is regarded as being particularly good for mobile 
development. LOVE 2D is available in Raspbian's 
repositories (sudo apt install love). You'llneed 
experimental OpenGL drivers enabled in raspi-config 
and a text editor, ideally with a Lua code highlighting 
module, to write your game in. 


He =120 


11,476 


Oh My Giraffe by Nico Prins 
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INFORM 1 
inform7.com 


An engine for creating parser text 
adventures (get lamp, light lamp, 


Hadean Lands by Zarfhome Software 


eat lamp) that lets you program 
games by writing sentences in 
natural English such as ‘The Cave 
is aroom. A dragon is here.’ 

It’s easy to get started by writing 
out a few sentences to describe a 
room and the items it contains, but 
the well-documented programming 
language has tremendous power 
that you can use to create anything 
from complex conversations to 
environmental physics. Only the 
command-line compilation tool 
is available for 32-bit systems 
like the Pi, but you can follow the 
documentation to write your game 
in a Standard text editor. 
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REN FY 


renpy.org 
Ren’Py is a Python-based game 
engine for making visual novels 

— a popular form of illustrated 
adventure game that originated in 
Japan. These can focus on dialogue 
or include puzzles, 
and typically have 
rich still graphics 
and at least mildly 
choice-based 
plots. Ren’Py 

has been used to 
make commercial 
hits like Long 

Live the Queen 
and can produce 
very polished 


results. Bear in mind, though, 
that Raspberry Pi support is 
still experimental and requires 
Fake KMS OpenGL drivers and 
extra graphics memory to be set 
in raspi-config. 


Long Live the Queen by Hanako Games 
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£4,000 DAY 1 —_resoay 
De Py 


TIC-&0 


code, create graphics, build levels, 


tic.computer -=te and write music. 
If you like the look of the fantasy It also supports a wider range 
computer trend but would prefer of programming languages 
to go for a free and open-source than PICO-8, with JavaScript 
option, the TIC-80 tiny computer and Moonscript as well as Lua. 
may tickle your fancy. It’s virtually Compiling from source works =— 

equipped with a 240x136 display, best on the RetroPie operating kre 

: 16-colour palette, 256 8x8 sprites, system and there's also a pre-built 

a, and four-channel sound, and has JavaScript version available to a 80 Days by Inkle Ltd 


a full set of integrated tools to edit download and run in your browser. 


“E” 5 magpi.cc/pBmacl a7 
. . » Achoice-based markup language, famously | 
-. used to develop the award-winning 80 Daysand .. , | 
"_ Sorcery games, Ink can be used as middleware Le 
_» alongside other game engines or to create " 
Me standalone narrative games. The open-source — | 

“Inky editor allows you to test games as you go, 
; “sand export them to a web- playable version for . 
*~ release. You’ll need to install mono-complete ~~)" 
= from Mono’s own repositories to build Inky - n 
full dependencies are listed in its readme file. 


CHOICESCRIPT own ChoiceScript games. The a ; op oe 


FPS80 by Bruno Oliveira ——— 


aa, TERE ES 


HE EEE FE egeamace ee 


magpi.cc/XSfqoo instructions on the download page 

ChoiceScript is the markup language area little out of date - you’ll now 

behind the very popular Choice Of find the extracted test game script at . SCRATCH 
series of interactive fiction games /web/mygame/scenes/startup.txt. | scratch.mit.edu 


for mobile and web platforms. 
They’ re simple choose-your-own- 
adventure style games, ranging 
from horror to romance, with 
an emphasis on quality writing. 
Choice Of Games even has a paid 
publication path with a 25% royalty 
rate for new writers and advances 
available to experienced authors. 
All you need is a text editor and 
the supplied files to make your 


Scratch comes with every Raspbian install. It’s well 
documented and is explicitly designed to be easy 
for beginner programmers, with a drag-and-drop 
interface that allows you to build up sequences 

of action and logic, including graphical and 

audio elements. 

The visual programming interface uses 
instruction blocks that bolt together and can be 
used to define text, control systems, variables, and 
more. A huge range of games, slideshows, and 
stories are available on the official Scratch website, 
and you can look at their code to learn by example. 


i] 


The Road to Canterbury 
by Choice of Games - 


| 
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PYGAME AND PISD tootkitforgettingthePitode 


pygame.org - magpi.cc/ZEIPjL something no one really expects 
Pygame and Pi3D are two sets of of it: 3D graphics rendering. 

games programming libraries for Don’t forget to allocate extra 

Python that are ideal for Pi users memory to the GPU before running — 


who are learning the fundamentals Pi3D’s demos. 
of game development. Pygame 
comes installed on Raspbian by 
default and is packed with useful 
functions for everything from 
physics to animation, with loads 
of examples and documentation 
available online. 

You’ll have to install Pi3D 
separately, but it’s a great Python 


Pi3D forest walk demo 
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Pi Zero W 


Pi Zero W case 
with three covers 


USB and HDMI 
converter cables 
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Use screenshots to show others how you set up the software for your projects 


Cance Take Screenshot 


Application 
Take Screenshot 


ra 


¢) Grab the whole screen 
i Grab the current window 
—y 
ae) Select area to grab 


Grab after a delay of 3 


pr@raspberrypi: ~ 


Effects 


Include pointer 


pi@raspberrypi: ~ 


) 
x 


nents Calculator png (357x371) 100% 


Aldcanffiles 
8 f=] Pictures 


Tutorial DY Warhuc: 


_ MIKE COOK 


Veteran magazine author from the old 
_ days and writer of the Body Build series. 
Co-author of Raspberry Pi for Dummies, 


Raspberry Pi Projects, and Raspberry Pi 
Projects for Dummies. 
magpi.cc /259aT3X 


| | “Tt 
—_ | | == 
i | i 
16 x 3-LED 
h light ° ° ° ° ° 
magpice/ The Matrix is an undedicated array of switches and lights 


ne een me that can be put to any number of uses — animated light 


Abe ciSplays, games, and controlling synthesizers, to name 


paint 


magpi.cc/ but three. Best of all, it won’t cost you a fortune 


vBcYrB 


16 «51092 — na thrift shop, we spied white LED stick-on use the same chip to also read the state of the push 
125mW resistors 


magpl.cc/ battery powered lights at only £1fortwo. That switches. As these are latching switches, we will then 
mDWDHU set us off thinking what we could make with use software to find out which switches have changed 
1280x18x6mm them. We came up with an illuminated switch matrix since we last looked at them. As three white LEDs are 
Strip pine that could be used for many things. At the end of the not too interesting, we will use transparent paint, 
idea project (in two or three issues’ time), after showing normally used for painting on glass, to make our three 
you how to interact with it, we thought we could set LEDs show different colours. 
eoraale you a challenge to see if you could write your own 
magpi.cc/ ad —w—? ne 
eluwAl software for a specific application. This is a project >STEP-O1 
oesomimn that will keep on growing. Mark out the box lid 
MDF 6mm thick We are going to use a MAX7219 chip to drive the We didn’t do this step ourselves first, but on 
magpi.cc/ LEDs; this removes any real time burden off the reflection we thought it would be easier to do before 
ict Pi. Then, by a crafty modification, we are going to the sides were put on the box. Cut a 320x320 mm 
piece of 6mm MDF and mark out the squares for 
80.00 mm each illuminated switch, then number them. This is 
320.00 mm | going to be the back of the box, hence the squares are 


numbered back to front. Each light will be in its own 
80mm space and you could change this if you want 


: a bigger or smaller board. Then mark the position 
S for the light’s fixing holes 15mm from the left-hand 
° side and 46.5mm from the top. The dimensions are 
: shown in Figure 1. 
oO 4 = 
$ S >STEP-02 
g Mark out the front 


Flip the board over and draw a light pencil line 

horizontal line across the whole board 46.5mm 

down from the top. Repeat this 46.5mm up from the 
bottom. Finally, draw two more lines 80 mm down 

from the top line and 80mm up from the bottom [ 


80.00 mm 


E line. This will serve as marker for when you later fix 
. E the lights. Now flip the board over and drill the 3mm \ 
+ = holes marked in Figure 1. Like all holes, drill onto 
% a scrap piece of MDF to ensure a clean edge to the 
hole, and clean up any bits of MDF round the hole 
Figure 1 Marking the underside of the board with a scalpel. 
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Fix adjacent sides Glue & Clamp 


Glue & Clamp 
Fitting the sides to the box 
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- gure 3 Drilling indents for glue to expand into 


Preparing the box sides 

Cut four pieces of 320x168x6 mm strip pine. Make 
sure the strip pine is the same size as the MDF. Mitre 
the ends of two pieces of strip pine at 45°, as shown 
in Figure 2. This can be done with a hacksaw and 

file — or better, if you have one, a disc sander with 


The push light’s components, from left to right: 
cover, lens, reflector, PCB, battery tray, and base 


igure 5 Removing the 
battery tray from the cover 


the guide set to 45°. Draw a line, using the strip pine 
as a rule down each side. Use a3mm drill and puta 
sequence of very shallow indents at approximately 
30mm spacing along the length of the strip pine, as 
shown in Figure 3. Then do the same for the MDF. 
This is to allow the glue to expand into the indents 
and have more grip. 


Fitting the box top and bottom 

Gorilla glue is a foaming expanding glue that works 
by the absorption of moisture. When you are ready, 
spray a small amount of water from a plant mister 
spray onto (or wipe with a damp rag) the surfaces 
you are going to join together. These will be the top 
and bottom sides. Apply a thin layer of glue to each 
side and clamp the two sides together. The strength 
of the glue joint depends on the two sides being 
clamped together. Allow the glue to set for at least 
two hours — see Figure 4. When set, trim off any 
elue that has seeped out of the joint on the outside 
with a scalpel. 


Fixing the box sides 
Referring back to Figure 2, take the other two lengths 
of strip pine and mitre them. This time, make sure 
there is a good fit between the two strips already 
attached. This might involve taking off a little more 


Figure 7 The unmodified PCB assembly 


until the side strips fit snugly. Now take the left- 
hand strip and file a shallow indent 51mm wide and 
2mm deep in the centre of the strip. This will allow 
a ribbon cable to the Raspberry Pi to slip out of the 
box when a base is fitted. This is represented by the 
hatched area in Figure 2. Again, drill shallow indents 
in the strips, spray with water, then glue and clamp 
to form the tray. 


Assessing the lights 

Take one of the LED push lights and take it apart; if 
you have any trouble detaching the battery tray from 
the base, see ‘Detaching the battery tray’ box. Then 
lay out all the parts as in Figure 6. To make sure we 
refer to them consistently, they are, from left to right: 
cover, lens, reflector, PCB, battery tray, and base. At 


Painting the first LEDs 

Paint the first LED — that is, the one between the 
wires attaching it to the battery tray — red. Make sure 
the paint is spread all over the LED and turn it upside 
down to dry. This is to ensure that any surplus paint 
collects over the tip of the LED, where the light is 
stronger. We used the base and odd bits of wood to 
make sure the wet paint did not touch the table - see 
Figure 8. If too much paint gathers, just touch the 
forming drop with a brush to drain the paint from it. 


this stage, the PCB and the battery tray are joined with | a 


two wires; let’s keep it like this for the time being. 


Preparing the LEDs 

Figure 7 shows the PCB with the LEDs on it 
attached to the battery tray with two wires. 

This might be a good time to test the unit by 
inserting the three AAA batteries and making sure 
the central switch turns the LEDs on and off. In order 
to make the light displays a bit more interesting, 

we are going to paint each LED in the light’s cluster 
with a transparent paint — this is normally used 

for making easy stained glass projects. You can get 
paint like this from any craft store. We chose the 
colours red, green, and blue, although you could use 
any you like. 


Figure 9 The 
finished paint job 


Tutorial 


Figure © Letting 
the paint dry with 
LEDs upside down 


DETACHING 
THE BATTERY 
TRAY FROM 
THE BASE 


Tutorial DW Warthewuc: 


The original 


schematic of the 


Latching switch push-on lights 


100 AA 


+1 
V4 SIZ 7 

pps 
>STEP-09 unpainted clear bits. At this stage, if you think the 
Finish off the painting colours are washed out, you can always add a second 
Allow the paint to become touch-dry, which can coat of paint, although on the final project the LED 
take two hours, and then paint the LED to the left brightness will be adjustable. 
of the red one green and again allow to become 
touch-dry. Finally, paint the LED to the left of the >STEP-10 
red one blue and this time leave it for 24 hours to Assessing the circuit 
become hardened. Figure 9 shows the finished Figure 10 shows the schematic of the LED’s PCB 
painted LEDs on the PCB board. Again, check with (printed circuit board). Trace through the circuit and 
batteries that the LEDs work and that there are no make sure that your lights are wired the same. The 10 Q 


9100 


Cathode schematic we need 


for this project 
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Figure 13 The final modified PCB 


Cathode 


Red LED 


AO 


+ve 
SW 


Figure 12 How to 
modify the light’s PCB 


resistor and the batteries’ internal impedance act as a 
crude limit to the current through the LEDs. The LEDs 
themselves are wired in parallel, which is not good 
practice, and the latching switch connects the positive 
anode of the LEDs to the positive of the battery supply. 
Other makes of light might be wired differently; be 
cautious if your PCB is not like the one shown here. 


The circuit we want 

We want to control the LEDs separately with a 
MAX7219 driver chip, which requires common cathode 
LEDs, so we must modify the PCB in order that the 
circuit is compatible with the MAX7219. Figure 11 
shows the schematic of what we want the PCB’s 
circuit to be. Each LED’s anode needs to be capable of 
a separate connection to the MAX7219, the cathodes 
need to be common, and the switch should connect to 
these cathodes through a 510Q resistor. This can bea 
replacement to the existing resistor, but if we make it 
a125mW one it will fit properly between the holes in 
the existing PCB. 


Replace with 5100 


Green LED 


4 
4 


4 
¢ 


Blue LED 


Modifying the PCB 

Figure 12 shows a drawing of the PCB with the 
modifications we need to make. We need to change 
the resistor, make three cuts to the PCB tracks, and 
wire a link between two points. At this stage we need 
not wire anything to the three LEDs nor the cathode 
or SW pads; we will do that later. Start off by removing 
all the resistors and replacing them with 510Q ones. 
Then you need to make three cuts in the PCB. This 
can be done with a scalpel, making two cuts very close 
together and peeling away the PCB between. Buta 
better way is to use a Dremel cut-off wheel and just 
make the gentlest of touches to remove the copper 
strip. Finally, use a small piece of wire to link the 
switch to the cathode lines. 


That concludes this month's article. 


Next month we will see how to make 
the control board for the matrix. 


Al 


FINISHED 
PCB 
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Tutorial 


PYGAME ZERO S250) 0 


Raspbian Jessie 
or newer 


An image 
manipulation 


program such as 
GIMP, or images 
from magpi.cc/ 
xdgVU 


The latest 
version (1.2) of 
Pygame Zero 


A lot of patience 
to play the game 


CTE D DV CTED 


THE 


SCRAMBLED 
CAT GAME 


A challenging game with minimal code using Pygame Zero Actors. 
In this third tutorial of the series, we introduce several new game 
programming techniques 


Wy 


hen your author first came across this type 

of game, it was in the form of a plastic frame 
with numbered tiles and was handed to him 
by his grandmother to keep him quiet for a while. It’s 
an infuriating game much like a 2D forerunner to the 
Rubik’s Cube, where the player must move jumbled 
up tiles around the frame to put them back into the 
correct order, except that there is only one spare space 
to move tiles into and you seem to end up with an ever 
more jumbled collection of tiles. In this version, the 
author’s cat, Widdy, has very kindly donated himself 
to be scrambled. 


>STEP-01 

Decisions, decisions 

When first approaching a sliding tile game, 

our first thought would be to have a matrix 

variable (or two-dimensional list) representing 

the frame with its tiles. You would then have a 
process function to handle the tiles moving around, 
changing the values in each of the matrix positions. 
However, Pygame Zero has a few tricks up its sleeve 
which work very well in this circumstance. Pygame 
Zero Actors are your friends and can save you a huge 
wedge of coding time. Let’s get stuck in and set 
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your program up with a few standard Pygame Zero 
basics, as in Figure 1. 


>STEP-02 

Getting the groundwork done 

Before we get into the visuals, you may notice that 
there are several functions in Figure 1 with just the 
keyword pass in them. In Python we are not allowed 
to have an empty function, so if we write pass in it, 

it means that the function should do nothing. This 
may sound a bit strange but it means that we can build 
the basic structure of our program before we start 
thinking about the finer details. Now that we have our 
structure, we can add some background graphics. If 
you have downloaded the graphics from our GitHub 
link (magpi.cc/xdgVJJ), we can add a background 
colour with screen. fill(red, green, blue) and 
then ‘blit’ a frame using screen.blit( ‘board’, 
(158, 50)) inthe draw() function. 


>STEP-03 

A night on the tiles 

You may have noticed the rather stylish wooden frame 
that is now displayed if you run the program. It was 
carved out of the author’s coffee table for this tutorial 
and will serve as the holder for the tiles we are about 
to create. All we need to do to create the tiles is to 
define a list to hold the tile Actors and then a function 
to create and arrange the new Actors in the frame. We 
can do this with a double loop to set the x and y co- 
ordinates of each tile. So first, define the tile list near 
the top of the code using tileList = [] andthen 

a function to make the tiles. Have a look at Figure 2 
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THE SCRAMBLED CAT GAME 


Oe 
You can find suitable | 
images for games ~ 
around the house. For | 
_thisgameweuseda — 
catandacoffeetable — 


WRITING 
YOUR 
PROGRAM 
STRUCTURE 


When creating 
your own 
programs, 
you can start 
by writing 

a structure 

of empty 
functions 
before writing 
the detailed 
code. This 
can help to 
visualise 

the way the 
program 

will work. 


7 Janguage 


>PYTHON 
Q1. pgzrun DOWNLOAD: 
@2. WIDTH 200 magpi.cc/xSnagK 
@3. HEIGHT = 600 
04. gameStatus 4) 
05. 
@6. def draw(): # Pygame Zero draw function 
07. 
08. 


@9. def update(): # Pygame Zero update function 
10. 

11. 

12. def on_mouse_down( ): 


13. 
Figure 1 The basic 

14. 
setup for our Pygame 
Zero program 


15. pgzrun.go() 


(overleaf) to see how we can do that. We can call our 
makeTiles() function at the end of the code, just 
before pgzrun.go(). 


>STEP-04 

Stating the obvious 

One technique that we have used in both previous 
tutorials in this series is to use a variable to keep track 
of the overall state of the game, and this game is no 
different. We need to know if the player is allowed to 
interact with the tiles or if they have completed the 
puzzle and a few other things too. For this we can 
define a global variable gameStatus = @near the top 
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COLLISION 
TESTING 


There are 
several 

ways to test 
collisions. For 
our border 
tests, we could 
have used 
border Actors 
and tested 
collision with 
them instead 
of using a 
mathematical 
check. 


of our program. In this game we will use the value o 
to allow the player to interact with the tiles, then 1 to 
show that a tile is being moved, 2 will mean that we 
are preparing the game (more on this later), and 3 will 
show that the player has completed the puzzle. 


>STEP-05 

Point and click 

In this game we will be using two different types of 
user input to give the player a choice of how to control 
the tiles. Players will be able to click on a tile to get 

it to move into the spare space, but we will provide 
the option to use the arrow keys too. These two 

input methods work quite differently, so let’s look at 


Figure2.py 


Q@1. def makeTiles(): 


mouse input first. Pygame Zero provides a function 
on_mouse_down(pos) so that we can capture a mouse 
click. We then compare the co-ordinates in the 
variable pos to the tiles to see if they collide. If they 
do, then the player has clicked on a tile. 


>STEP-06 

Which tile? 

To check which tile was clicked, we can use a for 
loop. We know how many tiles we have (15), so 

we can say for t in range(15):, where the 
variable t will be our counter. We can then check 
each tile to see if it has been clicked, with if 
tileList[t].collidepoint(pos):. While we are 
dealing with moving the tile, it’s a good idea to stop 
the player from interacting with the game, otherwise 
we may get several tiles trying to move at once. We 
can change the gameStatus variable to 1 to lock the 
input. See Figure 3 to see how this works in code. 


@2. global tileList 

Q3. xoffset = 251 >STEP-07 

Q4. yoffset = 151 Let's get things moving 

@5. Xx=y=ce=Q You may notice in Figure 3, in the middle of the for 

06. while y < 4: loop there is acall to moveTile(tileList[t]). This 

Q7. while x < 4: is a function that will determine which way a tile 

8. ete. cocs, can move. We are going to use the colliderect() 

@9. tileList.append(Actor("img"+str(c), method of our tile Actors to test all directions. If no 
pos = (xoffset+(x*100), yoffset+(y*100)))) collision is detected in a certain direction then we 

10. c += 1 know that we can move the tile that way. We will also 

11. x += 1 include a condition to test that the tiles cannot move 

fe x = Q woes Aaah Veneer: outside the frame, so we will be using two types of 

13. y t= 1 the Loop from 0-3 using x collision detection: one with the built-in Pygame Zero 


Actor objects and one with a boundary check. 


>STEP-08 
Repel borders! 


Sorry for that terrible pun, but first we need to stop 
the tiles being allowed through the frame border. 


Figure 3 Using a locking 
system while player inputs 
are being processed 


Figures py 


. def on_mouse_ down(pos): 


@2. if (gameStatus == 0): We can do this with a simple if condition for each 
@3. doLock() direction. So for the right border we would say 

Q4. for t in range(15): if(tile.x < borderRight): and then we would 
05. if tileList[t].collidepoint(pos): do our Actor collision test. We will need a border test 
Q6. m = moveTile(tileList[t ] ) for each direction. What we are actually doing in the 
Q7. if(m != False): moveTile() function is saying: “Can we move the tile 
e8. animate(tileList[t],on_ right, or left, or up, or downe” If the answer to any of 


Ffinished=releaseLock, pos=(tileList[t].x+m[1], 
tileList[t].y+m[2])) 


those is yes (and it can only be one of them or none), 
then tell us which way to move. 


09. return True 
10. releaseLock() >STEP-09 
11. Tiles to the left, tiles to the right 


12. def releaseLock(): There is a cunning plan you can use to test if a tile can 
13. global gameStatus move ina certain direction without seeing it move. If 
14. gameStatus = 0 you add 1 to the x co-ordinate of the tile and then test 
i Boye for a collision — we are going to use a function called 
16. def doLock(): checkCollide(tile) — then we will know if a tile is 
17. global gameStatus to the right of our test tile. We then set the tile back 
18. gameStatus = 1 to its original position by subtracting 1 from the x 


co-ordinate, and all this happens before the Pygame 
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Players can use the mouse or the 
keyboard to move tiles. Pygame Zero 
handles the animation frames with the 
animate() function 


Zero draw() function is called again so you never 
see anything move. We can also do the same test for 
moving right, up, and down. 


>STEP-10 

Collision course 

We need to write a function that will test to see ifa 
collision has happened when we moved our tile 1 unit 
(pixel). The checkCollide() function loops through 
the tile list and checks to see if any of the tiles are 
colliding with the tile that the player has clicked 

on. We just loop through the tile list and use the 
colliderect() method to test for collision (and also 
make sure we are not testing the tile that has been 
clicked) and if there is, return True. If no collision 
was detected then the function will exit with a False 
return value. Have a look at Figure 4 to see how we 
test a border and check for tile collision. 


>STEP-11 

Very animated 

We will need to add tests for left, up, and down to 

our moveTile() function; when that is done, it will 
return what is known as a tuple. This is a return value 
with several parts: the direction as a string, the x 
offset to move the tile, and the y offset to move the 
tile. This tuple gets sent back to our on_mouse_down() 
function and if it’s not False then we know we can 
move the tile based on the return values. We now 

call the animate() function. This is a Pygame Zero 
function to move an Actor from one place to another. 


>STEP-12 

Locking player interaction 

While we are animating the tile moving, we don’t 
want the player to be able to click on any other tiles. 
We have used our doLock() function to change the 
gameStatus to 1 So no mouse clicks are reacted to. 
When the animation has finished, we want the player 
to make their next move, so in our call to animate() 
we include on_finished=releaseLock. This will 

call the function releaseLock() which will set the 
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Q@1. def moveTile(tile): 


Tutorial 


Figure 4 An example of testing 
border collision and then using 
the Actor collision detection 


Q@2. borderRight = 551 

@3. rValue = False 

04. if(tile.x < borderRight): # can we go righte 

05. tile.x += 1 

06. if(not checkCollide(tile)): rValue = "right", 
100, @ 

07. tile.x -= 1 

08. 

9. return rValue 

10. 

11. def checkCollide(tile): 

12. for t in range(15): 

13. if tile.colliderect(tileList[t]) and tile != 


tileList[t]: return True 
14. return False 


gameStatus back to o. This will mean that the player 
can click on another tile. You will notice from Figure 3 
that if the mouse click is not on a tile then the lock is 
released at the end of the function. 


>STEP-13 

Using the arrows 

The second way that we can capture the player’s input 
is to use the arrow keys. This form of input relies on 
the fact that if an arrow key is pressed (for example 
the up arrow), there is only one tile that is able to 
move in that direction — or alternatively, no tiles are 
able to move in that direction. So all we need to do is 
work out which tile can move in the direction of the 
arrow pressed. We are going to do this with a function 
called findMoveTile(moveDirection) and we pass it 
the direction of movement that we want it to look for. 


>STEP-14 

Scanning the keyboard 

First, we must check if the player is pressing one 

of the arrow keys. We do this in our update() 
function. We want to check if the gameStatus is 0 
before processing anything; if it is, we can check 

the left arrow key by writing if keyboard.left: 
findMoveTile("left"). We then write a similar 
line of code for each of the other arrow keys, passing 
a different string to our findMoveTile() function. 
In the latter function we use the same moveTile() 
function as we did with the mouse click input, but this 
time we check for the direction that has been passed 
by the keyboard press check. 


>STEP-15 

Which tile is it? 

Now all we need to do is write the FindMoveTile() 
function that scans through the tile Actors and 


MULTI- 
PURPOSE 
FUNCTIONS 


Try to write 
your functions 
so that they 
can be used 
in different 
ways, like our 
moveTile() 
function. 

If there is 
less code to 
write, there 

is less code 
to debug. 


WATCH 
OUT FOR 
MULTIPLE 
INPUT 


When using 
the Pygame 
Zero keyboard 
object to 

test for key 
presses, it 
doesn't return 
just a single 
event. It will 
continuously 
read as True 
while the 
player holds 
the key, which 
may not be 
what you are 
expecting. 
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Figureo.py 


01. 
02. 
03. 
04. 
05. 
06. 
07. 
08. 
09. 
10. 
11. 
12. 
13. 
14. 


LS 
16. 
17. 


Figureb py 


02. 


03. 
04. 
05. 
06. 


07. 
08. 
09. 
10. 
11. 


a2. 
u Bc 
14. 
15. 
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Figure 5 Moving tiles from 
the detection of a key 
press on the arrow keys 
def update(): # Pygame Zero update function 
if (gameStatus == 0): 
if keyboard.left: findMoveTile("left") 
if keyboard.right: findMoveTile("right") 
if keyboard.up: findMoveTile("up") 
if keyboard.down: findMoveTile("down" ) 


def findMoveTile(moveDirection): 
doLock() 
for t in range(15): 
m = moveTile(tileList[t] ) 
if(m != False): 
if(m[@] == moveDirection): 
animate(tileList[t],on_ 
Ffinished=releaseLock, pos=(tileList[t].x+m[1], 
tileList[t].y+m[2])) 
return True 
releaseLock() 
return False 


Figure 6 The scrambleCat() 
function. Pass a List of simulated 
keystrokes to findMoveTile(), just 
scrambleCountdown = 30 like if we were pressing the keys 
Scramblebisty— 20, 2.50, 3.01 1 2 0 0, 2, 
1, 2, 1, 3, 3, 9, 3, 0, 2, 0, 2, 2, 1, 3, 1, 3, 3; 


1, 2] 


def scrambleCat(): 
global gameStatus, scrambleCountdown, 
scrambleList 
tileDirs = ["Left"; “right”, “up; down | 
if(scrambleCountdown > @): 
mt = False 
while(mt == False): 
= findMoveTile(tileDirs[scrambleList[ 
scrambleCountdown | | ) 


scrambleCountdown -= 1 
gameStatus = 2 
else: 
gameStatus = @ 


finds the one that can move in the direction that the 


player has pressed. We loop though our tile list and 
try to move each tile. If we find it can move then we 
check the direction of movement. If it matches the 


direction that we are looking for then we have a match 


and we can initiate the animation to move the tile. 


Figure 5 shows this whole process, from key press to 


animation. Note that we are locking and unlocking 
the gameStatus while this is happening, to avoid 
multiple moves at once. 
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>STEP-16 

Time to scramble the cat 

The game is not much fun if we start witha 
completed puzzle, so we need to add a system for 
mixing up the tiles. There are various ways we could 
do this, but we thought it might be quite nice if we 
Start the game with the tiles being scrambled move 
by move. We can do this by simulating key presses 
using the same functions as in the previous steps. We 
can use a new gameStatus of 2 to indicate that the 
player can’t interact, then cycle through a predefined 
or random set of simulated key presses until 
everything is jumbled up. We have used a predefined 
list in this case. 


>STEP-17 

How scrambled is scrambled? 

For our scrambling, we can have a list of 
movements. If we alter the number of movements 
we are using then the game becomes more or 

less difficult. We can start at 30 and see how that 
works. Our scrambling function, scrambleCat(), 
calls the findMoveTile() function and uses the 
scrambleCountdown variable to check if we have 
made enough moves. After each animation, we are 
using a bit of a cunning trick: we always call the 
releaseLock() function after an animation so 
we can slip in a test to see if gameStatus is 2 and if 
so, call scrambleCat() again. See Figure 6 for the 
scrambleCat() function. 


>STEP-18 

Have we won yet? 

At some point in the game, there is a slim chance 
that the player will actually rearrange the tiles back 
into the correct order. We will need to write a check 
to see if this has happened each time a tile has been 
moved. We know that the positions of the tiles were 
correct before we scrambled them, so what we can do 
is make a list of the x and y co-ordinates of each tile 
when we first make the tile Actors. Then all we need 
to do is to compare that list with the current x and 

y values of our tile Actors and if they all match, we 
have a winner! 


>STEP-19 

Finishing touches 

You can see from the full program listing the 
checkSuccess() function and how that works, 
and we can also add some text prompts into our 
draw() function based on the value of gameStatus. 
That’s about it! We have a working Scrambled Cat 
game. You may want to add some features such 
as a score based on how many moves the player 
makes, or you may want to change the images. 
You could have scrambled egg or a scrambler bike 
or make the tile matrix larger for an even more 
difficult challenge. 
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scrambledcat.py 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 


0e9. 
010. 
011. 
012. 
013. 
614. 
015. 
016. 


017. 


018. 


019. 
620. 
@21. 
@22. 
623. 
624. 
625. 
626. 
027. 
628. 
629. 
030. 
@31. 
@32. 
933. 
634. 


935. 
036. 
037. 
038. 
939. 
040. 
041. 
042. 
043. 
044. 


045. 
046. 
047. 
048. 
049. 
050. 
@51. 
@52. 
053. 
054. 
655. 
056. 
057. 


import pgzrun 

WIDTH = 880 

HEIGHT = 600 
gameStatus = 9 
tileList = [] 
correctList = [] 
scrambleCountdown = 30 


Seramblelist- = [2,°0,°2,°0,.3,.1, 1.0, 3,°6,.0,.2, 15.2, 1; 


3, 3, 0, 3, @, 2, @, 2, 2, 1, 3, 1, 3, 3, 1, 2] 


def draw(): # Pygame Zero draw function 

global gameStatus 

screen.f1i11((141, 172, 242)) 

screen.blit('board', (158, 50)) 

for t in range(15): 

tileList[t].draw() 

if (gameStatus == 3): screen.draw.text("Success!" 
> (5150 20), OWwidth—0.5,. ocolor—(255 255,255), 
color=(128,64,0) , fontsize=60) 

if (gameStatus == 2): screen.draw.text("Please wait 
while we scramble the cat", (135, 540), owidth=0.5, 
ocolor—(255, 255.255), color-(123,64,0) | fontsize—a0) 

if (gameStatus <= 1): screen.draw.text("Click on a tile 
to move it or use the arrow keys", (95, 540), owidth=0.5, 
ocolor=(255,255,255), color=(128,64,0) , fontsize=40) 


def update(): # Pygame Zero update function 
if (gameStatus == @): 
if keyboard.left: findMoveTile("left") 
if keyboard.right: findMoveTile("right") 
if keyboard.up: findMoveTile("up") 
if keyboard.down: findMoveTile("down") 


def on_mouse_down(pos): 
if (gameStatus == @): 
doLock() 
for t in range(15): 
if tileList[t].collidepoint(pos): 
m = moveTile(tileList[t]) 
if(m != False): 
animate(tileList[t],on_ 
finished=releaseLock, pos=(tileList[t].x+m[1], tileList[t]. 
y+m[2])) 
return True 
releaseLock() 


def findMoveTile(moveDirection): 
doLock() 
for t in range(15): 
m = moveTile(tileList[t]) 
if(m != False): 
if(m[@ ] 


moveDirection): 


animate(tileList[t],on_finished=releaseLock, 


pos=(tileList[t].x+m[1], tileList[t].y+m[2])) 
return True 
releaseLock() 
return False 


def releaseLock(): 
global gameStatus 
if(gameStatus == 2): scrambleCat() 
else: gameStatus = checkSuccess() 


def doLock(): 
global gameStatus 
gameStatus = 1 


raspberrypi.org/magpi 


Tutorial 


@58. def checkSuccess(): 


@59. for t in range(15): 

062. if(tileList[t].x != correctList[t][@] or 
tileList[t].y != correctList[t][1]): 

061. return 9 

062. return 3 # we have success! 

063. 

Q@64. def makeTiles(): 

065. global tileList, correctList 

066. xoffset = 251 

067. yoffset = 151 

068. X=y=ce=@0O 

Q69. while y < 4: 

070. while x < 4: 

Q71. if(c < 15): 

Q72. tileList.append(Actor("img"+str(c), pos = 
(xoffset+(x*100), yoffset+(y*108)))) 

073. correctList.append( (xoffset+(x*100) , yoffset 
+(y*100))) 

074. c += 1 

075. X t= 1 

076. X = @ 

077. yt=1 

078. scrambleCat() 

079. 

Q@80. def scrambleCat(): 

081. global gameStatus, scrambleCountdown, scrambleList 

082. tileDirs = ["left", "right", "up", "down" ] 

083. if(scrambleCountdown > @): 

084. mt = False 

085. while(mt == False): 

086. mt = findMoveTile(tileDirs[ scrambleList[ scramble 
Countdown] ] ) 

087. scrambleCountdown -= 1 

088. gameStatus = 2 

089. else: 

090. gameStatus = 9 

g91. 

Q@92. def moveTile(tile): 

993. borderRight = 551 

994. borderLeft = 251 

995. borderTop = 151 

096. borderBottom = 451 

097. rValue = False 

098. if(tile.x < borderRight): # can we go right? 

e99. tile.x += 1 

100. if(not checkCollide(tile)): rValue = "right", 100, 0 

101. tile.x -= 1 

102. if(tile.x > borderLeft): # can we go left? 

103. tile.x -= 1 

104. if(not checkCollide(tile)): rValue = "left", -100, 0 

105. tile.x += 1 

106. if(tile.y < borderBottom): # can we go down? 

107. tile.y += 1 

108. if(not checkCollide(tile)): rValue = "down", @, 100 

109. tile.y -= 1 

110. if(tile.y > borderTop): # can we go up? 

111. tile.y -=1 

112. if(not checkCollide(tile)): rValue = "up", @, -100 

113. tile.y += 1 

114. return rValue 

115. 

116. def checkCollide(tile): 

117. for t in range(15): 

118. if tile.colliderect(tileList[t]) and tile != 

119. tileList[t]: return True 

return False 

120. 

121. makeTiles() 

122. pgzrun.go() 
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EP BY STEP 


TEENAGE 


> 12V Adafruit 
3-Way Tower 
Light 
magpi.cc/ 
OUocBH 


se i » 
i | >12V 2APSU with 
at 74 barrel connector 
5) magpi.cc/ 

—) =VhOBJY 


- oo 
‘ 


“ 


> Automation 
pHAT 
magpi.cc/ 
RhPiSs 


> Wide Input 
j SHIM (Optional) 
j magpli.cc/ ' 
RWEDNE 


The light takes its power from 
the Wide Input SHIM, so only 
one PSU is needed 


The Automation pHAT 
allows the safe switching 
of 12V lights 


» 
sl hes 


50 | MdgPi September 2018 


PJ EVANS 


PJ is a software engineer who runs 
the Milton Keynes Raspberry Jam. His 
home automation projects have got 
completely out of hand. 
mrpjevans.com 
twitter.com/mrpjevans 


Always yelling ‘Dinner!’ toa 
teenager or shed-dweller? Save your 
vocal cords by installing a tower light 
you can control from your phone 


f you’re blessed with teenagers or others who 

like to lock themselves away in their room/ 

shed/craft-room, you may well be fed up with 
shouting up the stairs or out into the garden when 
you need their attention, especially if headphones 
are involved. Why not signal your loved ones visually 
from your phone using a cheap industrial tower light, 
a Raspberry Pi, and some Python? You’1l learn about 
interfacing the Pi with normally incompatible devices 
and how little code is required to create a web server. 

This project was inspired by James West’s klaxon: 

jameswest.site/the-tea-time-klaxon. 


Get your Pi ready 

This project can be built using any 40-pin version 

of the Raspberry Pi capable of WiFi and it’s perfect 

for the Zero W. Once complete, the tower can run 
‘headless’, so no monitor or keyboard will be required. 
Raspbian Lite is ideal for this as there is no need fora 
fancy user interface. 

Start by installing Raspbian Lite on your microSD 
card (see magpi.cc/etcher), then booting up and 
running sudo raspi-config. Get WiFi set up and 
under ‘Interfacing’, make sure both I?C and SSH 
are enabled. Finally, set the Pi’s host name under 
‘Networking’ as we’ll need it later on. 


Prepare the Wide Input SHIM 

So we can safely power the lights and the Raspberry 
Pi from a single 12 V PSU, we’re using the Pimoroni 
Wide Input SHIM, a tiny power regulator for the Pi. 
To power the lights, we’re going ‘tap’ the SHIM to 
eet ai2V feed by using the on-board power inputs as 
a supply. Carefully solder two wires to the positive 
and negative pads on the SHIM. We don’t want them 
shorting out on the Pi when the SHIM is in place, 
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A close-up of the Wide Input SHIM. Here 
you can see the positive and negative 
pads from which we take the 12V current 


so make sure the solder points are trimmed back as 
much as possible and covered with insulation tape. 


>STEP-03 

Install the Wide Input SHIM 

The Wide Input SHIM mounts on the first twelve pins 
of the GPIO. It is intended to sit flush at the base of 
the pins, so HATs can still be used on top. Therefore, 
the board needs to be precisely soldered directly on to 
the GPIO pins. 

Place the SHIM onto the GPIO pins, aligning with 
physical pin 1 (see photo). Secure with masking tape 
and solder into place starting with pins 1 and 12, then 
you can remove the tape. Take your time. You should 
now be able to power up your Pi using the barrel 
connector and 12V supply. 


>STEP-04 

Add the Automation pHAT 

Although we can now power both the Pi and the lights 
from a single 12 V supply, the Pi cannot switch the 
lights directly without releasing the magic smoke. 
Pimoroni’s Automation pHAT is a general-purpose 
collection of inputs and outputs for projects such as 
this one. For our lights, it features three switchable 
outputs that can handle 12 V just fine. 

You’ ll need to solder the supplied GPIO connector 
and the screw terminals to the pHAT. Check and check 
again that the orientation is correct. Once ready, 
attach the pHAT to the Pi with the Wide Input SHIM 
sitting in-between. 


>STEP-05 

Wire up the tower light 

Now our control device is complete, we can attach 
the tower light itself. There are five wires: one for 
each colour, a buzzer (that we’re not using), and12V 
in. Following the diagram, connect the wires to the 
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The Wide Input SHIM is soldered directly to the 
GPIO pins so the pHAT can sit on top. Note the 
12V feed we're taking from the board 


Automation pHAT. The brown wire is the power in, 
So we connect that to the 12 V feed we took from the 
SHIM earlier. The three colour wires (red, yellow, and 
ereen) are connected to the three screw terminals 
labelled ‘Output Sinking 24V’ on the pHAT. Finally, 
the earth wire from the SHIM needs to connect to the 
earth on the pHAT. 


>STEP-06 

Install Automation pHAT software 

Your hardware is ready, so it’s time to get some code 
running. Power up and, from the command line, 
make sure you’re up to date with sudo apt update 
&& sudo apt upgrade. Pimoroni takes away all the 
pain of installing drivers for the Automation pHAT by 
providing a simple one-line install: 


curl https://get.pimoroni.com/ 
automationhat | bash 


If soldered 
correctly, the 
SHIM should not 
interfere with 
Automation pHAT 


SOLDERING 
THE SHIM 


When 
attaching the 
SHIM, use a 
thin tip on your 
iron and be 
very careful 
not to touch 
components 
on the Pi. 
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CAREFUL 
WITH THAT 
POWER! 


When using 
the SHIM, do 


not attempt 
to power the 
Pi using a 
regular USB 
supply at the 
same time. 


, e-, 


®330906400239°98 


39429009039 
7293933954893 300e8S8 9 


s7¢e¢°*3° 
D3 AUTOMATION PHAT UE 


* 


v0 0) WIDE 
wa SINPUT 
wa SHIM 


tie Pimoroni.com 


lt 3) 


Here's how all our devices connect. The SHIM provides the power, 
then the Automation pHAT safely switches the 12V current 


The script takes a few minutes to run. Once 
completed, allow it to reboot the Pi (if required) and 
then you’re ready to try things out. 


cd ~/Pimoroni/automationhat/examples 
python output. py 


Do you see two blinking lights on the tower? If so, 
it’s all working. Press CTRL+tC to stop. 


>STEP-07 

Install Flask 

There are many options for remotely controlling 

the lights, such as Twitter or even email. One of 

the easiest is to run up a Simple web server on the 
Raspberry Pi itself. To keep the code as simple 

as possible, we’ll use the Flask web application 
framework for Python, which does all the heavy lifting 
for us. Installation is as simple as: 


sudo -H pip install flask 
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Each line from the light is 
connected to one of the 
three ‘output’ terminals. 
The ground from the 
SHIM connects to the 
ground on the pHAT 


>STEP-08 

Code! 

From the /home/pi directory (if you’re not sure, 
just type cd followed by RETURN), issue the 
following command: 


mkdir ~/towerlight && cd ~/towerlight 
Now create a new file: 
nano towerlight.py 


Enter the code shown here (or you can download it 
from GitHub). Save the file (CTRL+X, then Y). When 
run, this script will fire up a basic web server. 

The code uses the Flask and Automation pHAT 
Python libraries to allow simple switching of the 
output terminals, allowing the individual lights on the 
tower to illuminate. Every time a web request comes 
in, all the outputs are switched off, then the selected 
one is illuminated. 


>STEP-09 
Testing time! 
To start the web server, just run: 


python ~/towerlight/towerlight. py 


You’ll see a few announcements on screen 
and then it will wait for requests. Using the host 
name you set earlier, or the IP address of the 
Raspberry Pi (you can run ifconfig to discover 
this), go to http://hostname.local:5000/ or 
http://ip-address:5000/ from any web browser. 
If the ‘.local’ address does not work and you’re on 
Windows, you may need to install Apple’s Bonjour 
Services (magpi.cc/JSUBrT). 
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@ 
The simple website you should now see allows you lower, light -Py 


to switch each light on and off by clicking the links. 


>PYTHON 


Q@1. import automationhat 


>STEP-10 @2. import time DOWNLOAD: 


@3. from flask import Flask i. 
Start on boot Q@4. app = Flask(__name_ ) ponies rete 
To start the web server whenever we boot the Pi, we Q5. 
need to create a service file: 06. # Generate a simple HTML page. You could also use Flash's built-in 
Jinja Templating. 
@7. def makePage(body): 


sudo nano /1ib/systemd/system/towerlight. 08. SEch 
service @9. <!DOCTYPE htm1> 
10. <html> 
11. <head> 
And populate it as follows: 12. <meta name="viewport" content="width=device-width, 
initial-scale=1.0"> 
[Unit] 13. </head> 
Description=TowerLight a a ar 0a) as 
: : <hr/> 
After=multi-user. target an ers 
17. <li><a href="red">Red</a></1li> 
[Service] 18. <li><a href="yellow">Yellow</a></1i> 
Type=idle my ee ae ee oe 
? : : <a < = > </a></1i> 
ExecStart=/usr/bin/python /home/pi/ 1 Oreae etch ° : 
towerlight/towerlight.py 22. </html> 
23. '4et 
[Install] wa 


dBy=multi 25. # This function runs every time a request is received before routing. 
WanteaBy=multi-user. target 26. # We switch off all the lights here. 


27. @app.before_ request 


Now, install the service: 28. def allOff(): 
29. automationhat.output.one.off() 
. 30. automationhat.output.two.off() 
sudo chmod 644 /lib/systemd/system/ 31. automationhat.output.three.off() 
towerlight.service a2. 
sudo systemctl daemon-reload 33. # Our default home page 


34. @app.route('/') 
35. def index(): 
36. return makePage('Index' ) 
The server will now start automatically on reboot. 37. 
38. # The next three functions switch on the three lights 
>STEP-11 39. @app.route('/red') 
40. def red(): 
Assemble! 41. automationhat.output.one.on() 
Once you’re happy with testing, you can shorten the 42. return makePage( 'Red') 


leads as you see fit. It’s straightforward to mount the 
tower on top of a small project box and feed the wires 


sudo systemctl enable towerlight.service 


44. @app.route('/yellow') 
45. def yellow(): 


through. Mount the Pi inside with hot glue or sticky 46. automationhat.output.two.on() 
pads, with the large barrel connector lead supplied 47. return makePage( ‘Yellow’ ) 
with the SHIM accessible from the outside. = 


49. @app.route('/green') 


Congratulations, you now have the perfect teenager/ 50. def green(): 
shed-dweller alerting device in a single unit that can 51. automationhat.output.three.on() 
be controlled from your phone or any web browser. 52. return makePage( ‘Green’ ) 
53. 
54. # Switch everything off 
> ra 
STEP 12 55. @app.route('/off' ) 
Make it your own 56. def off(): 
What we’ve made here is fairly basic, so there’s lots 37. return makePage('Off') 
; ; 58. 
to build on. Why not try improving the website and 59. # Let's announce ourselves by making the lights blink 
learning about Flask templates® How about a disco 6. automationhat.output.one.on() 
mode? The tower comes with a (very loud) buzzer, could 61. time.sleep(Q@.2) 
you add it in° What are the other things that could 62. automationhat.output.one.off() 


63. automationhat.output.two.on() 


i 1 ° i ° ° 
trigger the lights: Twitter: A remote button: Also, noe teen (one 
don’t forget there are plenty of inputs to play with on 65. automationhat.output.two.off() 
the Automation pHAT, so the lights could also react to 66. automationhat.output.three.on() 
sensors. Check out magpi.cc/TSEFXL for an alternative 67. time.sleep(@.2) 
; 68. automationhat.output.three.off() 
version of the klaxon software with extra features. 69. 


70. # Start the web server on port 5000 
71. if _mame__ == '_ main_': 


rasoberrypi.org/magpi 
poerryplLorg/mMagp 72. app. run(host='0.0.0.0') 
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> Raspbian 


> Some tasks 
to automate 


MORE 
CRONTAB 
OPTIONS 


Using nano to 

edit text within the 
Terminal relies on 
using the keyboard 
without the mouse 


GARY PICKUP 


An experienced IT Consultant who 
enjoys all things geek and sharing 
knowledge, who once appeared in 
a Marvel comic book. 
geektechstuff.com 
twitter.com/geektechstuff 


AN INTRODUCTION TO 


Ever find yourself loading the same webpages around the same 
time daily for a catch-up on the latest Raspberry Pi news? 
Get your Pi to do it automatically with cron 


ron is a piece of software that is built into 

the Raspbian operating system and is used to 

schedule (automate) tasks to run at different 
intervals (e.g. every five minutes), times, or dates. 
Cron was originally designed to automate system 
administration within UNIX systems; however, due 
to its diversity, we can use it within Raspbian to 
automate tasks such as opening applications, loading 
webpages, and running Python scripts. 


Launch Terminal 
To configure cron, we will be using a text editor 
within the Terminal — the latter can sometimes seem 
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daunting, but it opens up lots of possibilities and 
access to utilities like cron. To quote Douglas Adams, 
‘Don’t panic!’ By default, the Terminal has a shortcut 
at the very top of the Raspbian desktop; click it to 
receive a prompt that says pi@raspberrypi: — and it’s 
time to start. 


Launching cron 

Cron is configured via files called crontabs. Each user 
account on the Raspberry Pi can have its own crontab; 
however, this tutorial will be dealing with creating a 
crontab for the default Pi user. At the pi@raspberryp1: 
prompt, type crontab -e. the ‘-e’ is very important 
as this tells Raspbian that we want to edit our crontab. 
The Terminal will output ‘no crontab for pi — using 
an empty one’; this is because we are creating our 
first crontab. 


Welcome to your first crontab 

The Terminal will open a crontab in the default 

text editor, which for Raspbian is nano. Nano uses 
keyboard combinations to save and exit files, unlike 
eraphical text editors where clickable menus are 
used. The crontab already contains a lot of text that 
has been commented out using hashes (#); this text 
is an introduction to cron and worth reading. Once 
read, use the down arrow on the keyboard to get to 
bottom of the file, just below them h dom mon dow 
command line. 


raspberrypi.org/magpi 


{ The File Edit Tabs Help 
j GNU nano 2.7.4 
d ti 


nispberrypiorg/magpi M agaz in 


Cron can be used 
to schedule a web 
browser to open 
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pi@raspberrypi: ~ 


File: /tmp/crontab.HAQx3n/crontab 


il le INCLUDES 


Cron tasks are text lines that 
tell cron what to do and when 


WITH A 12 MONTH PRINT SUBSCRIPTION 


Scheduling a task 

The m (minute) h (hour) dom (date of month) mon 
(month) dow (day of week) command line gives a fleeting 
look at how cron can schedule a task. We will be using 
it to open our favourite website at 7.30am daily, but 
this could very easily be 7.30am every Thursday, or on 
the first day of every month. When writing a value for 
these options, we must provide either a number or an 
asterisk (*). The * means any. 


Let’s launch a web browser 
To launch a web browser at 7.30am every day, we need 
to enter the following line of text: 


30 7 * * * export DISPLAY=:0 && chromium- 
browser https://www.raspberrypi.org/magpi/ 


This line says at 30 minutes past the seventh hour 
on every day of every week in every month, run 
the command export DISPLAY=@ && chromium- 
browser, which opens the web browser Chromium and 
tells it to open the website raspberrypi.org/magpi. The 
export DISPLAY=:0 &8& part is required to make sure 
cron displays the web browser on screen. 


Saving the crontab 
Once the line of text has been entered, we need to save 
our crontab. Unlike a graphical word processor, nano 
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Dont worry about the name, 
as Raspbian will name the 
crontab appropriately 


requires that keyboard combinations are used to save 
the crontab and exit. Press CTRL+tO to open the save 
file option, and then press ENTER to save the crontab. 
Don’t worry about the name, as Raspbian will name 
the crontab appropriately. With the crontab saved, 
press CTRL+X to exit nano. You can now sit back 

and watch as cron runs your automated task at the 
scheduled time. 


File Edit Tabs Help CRON 
ete Saracen ales SHORTCUTS 


There are various crontab commands available to edit, 
list, or delete the tasks that cron has been asked to do 
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BRIAN BEUKEN 


Very old game programmer now 
teaching very young game programmers 
a lot of bad habits at Breda University 

of Applied Science in Breda NL. 
scratchpadgames.net 


ON THE RASPBERRY PI 
PART 09 


It’s time to go a bit retro and make our game look better 


e’ve done most of the ‘hard’ work so far: There’s a very good reason in this game why we 
we have enemies, we have control, we can kept our window to a size that would allow us to see 
code eink interact with our map, and we are almost the whole game: it allowed us to see the whole game! 
: sada. apt_pet ready to interact with our baddies. But as a game, it’s That might seem very obvious, but if we had reduced 
codeblocks dull: one big window with the whole game visible. the view area to a window, it would mean we’d have 
» FresTypez That’s not how we remember our old retro games. to actually play the game so we could get to a point 
It’s time to consider the appeal of our game and where we could see if our characters were behaving 
> stb_image.h ' ‘ ’ 
(edo tach ened make changes to the display and the map, to create as we expected. At the moment, while they’re a bit 
satisfying gameplay. small and hard to distinguish, we can comfortably see 


Scaling up a lp Ft 
the graphics ce} Ty 1332 


USE 
SWITCHABLE 


VIEWS 
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that all the enemies are where we expect them, and do 
what we expect of them. 


Step through it 


A second point is much harder to get excited about, 
as for the most part you’ve had code to download 
which you knew was working, so there would be 
little reason to actually inspect and step through 
your code. But it is an important thing to be able to 
do. This is one reason why most coders like to use 
two systems to work on: one to edit, compile and 
debug, and one to run on. This is possible using two 
Raspberry Pi systems or a PC and Pi, but it does need 
a bit of setting up — we will cover this another time. 

Back to viewing the whole game. What we are in fact 
currently doing is visualising the whole of the play 
area, or map. We’ve allowed our map co-ordinates to 
directly reflect our screen co-ordinates, but we have 
the capacity to scale things up and view a window into 
our map that we can drag along with our player. 

But before we can do that, we need to acknowledge 
that some things we did previously to make life easy 
for us are now going to bite us. 


Magic numbers are bad 

We’ve mentioned before, mostly in the code, that 
hard-coding our tile sizes to actual numbers like 16 
isn’t a good idea. Yes, it’s the actual number of pixels 
the image has, but now we have a predicament: if 
we’re going to scale up the visuals to allow for 64x64 
pixel tile size, we have to go through all our code and 
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take note of every use of the number 16 as it relates 
to the size of a tile, and change it manually (Figure 1). 

We can’t just do a global find and replace, because 
there are some cases where the number 16 is actually 
fully legit. We are still interacting with our map using 
16x16 tiles; it’s only the display that will change. 
These so called ‘magic’, or hard, numbers are very 
prone to error if you miss one when trying to change, 
and it’s rather tedious to go through an entire project 
checking and changing every instance, once it gets 
beyond a certain size. 

This is where we need to use one of the standard 
concepts of C/C++ to define our value in a way that’s 
easy to change. 


#define A_CHANGEABLE_VALUE 16 


Now in your code when you are referring to the 
magic value, use the label ALCHANGEABLE_VALUE, 
which gives us a nice helpful way to alter things 
because you only have to change the #define once! 

The Game.h file has set the size of the tiles as a 
#define; since they are square, we use the same value 
for x and y sizes. Try altering the sizes and you will see 
that one change allows you to have any size of screen. 
Don’t make it too big, though: since our original 16 
size was only 16x16 pixels, you can See our scaling is 
stretching things quite a bit. 

We can also scale up our sprites using a similar 
system, as a proportion of our actual tile sizes vs our 
image size. 


Figure 2 Full- 
screen glory, but 
where's Bob? 


LOAD ONLY 
WHAT YOU 
NEED 


We will cover 
this in more 
detail next 
time, but take 
a small note of 
how much you 
are loading 
and how often. 
Be aware of 
things like this. 


September 2018 MadgPi 


57 


Tutorial WALKTHROUGH 


AVOID 
MAGIC 
NUMBERS 


If you are likely 
to change a 
value, don't 
hard-code 

it. Magic 
numbers 

can cause a 
lot of bugs 
when you find 
you have to 
change them. 


Figure 3 Drag the 
screen along using 
fixed distances 


Now when we draw our tiles and sprites, we need to 
remember that our sizes and positions have to reflect 
these new scale values and they will therefore only be 
visible in the part of the screen we are focusing on, 
which sadly to begin with is going to be the top-left 
corner (0,0). 


OK screen, follow me 

Now we can display the screen any size we 

want, while the map is busy doing its updates 
independently. We want to get the screen to focus 

on our area of interest, namely where our player is. 
He has to be the controlling system that allows the 
screen to scroll around and lets us see what is directly 
around him. 

That’s not so hard to do. If we keep note of where 
in the map our player is, we can consider that the 
corner of the screen that we want to see is relative to 
his position; that is easy to calculate. 

Imagine Bob has a pole that’s a fixed length, and 
he ties it to the screen; as he moves, he pulls the 
screen ‘window‘ around with him, so the window 
itself has co-ordinates that start at a set distance 
behind Bob. We know that the corner of the screen 
will be a certain x distance away, and a certain y. 
Voila, we have the basics of a scroll system that 
centres on our main character (Figure 3). We can 
make minor adjustments to deal with the windows 
co-ordinates are at the edges of the map, and even 
make small allowances to allow Bob to move freely 
within a centre window area without scrolling. 
Check out the Bob class to see how that is worked 
out and passed back to the tile render system to 
reposition things. 


One more step to full arcade mode - and this is 
an easy one to do on the Raspberry Pi — is to set our 
screen to full. The Raspberry Pi range has a couple of 
nice features that let us ask the display code how big 
the screen is, which in turn lets us set the size. Set 
#define FULLSCREEN to true in Game.h, and see the 
result (Figure 2). 

There has been one niggle all through our 
development of our game. When we press the keys in 
our game, it often does something to folders or open 
projects on our desktop; we really should stop that. 
Because our OS is running, it is naturally going to read 
keys, but we saw early on that using the OS to read 
keys in our game wasn’t ideal. But having both our 
own key reader and the OS reader causes niggles. 

The redirection code can be found in the game 
Startup code, and importantly the restore code as the 
game exits. We don’t really have to do that, but it’s 
good practice to leave our system as close to the way 
we entered it as we can. 


Finally some text 

Printing text is easy, isn’t it? We just use a printf 
function or a cout or some other variation. Hmm, well 
no, sending text to buffers and console display is easy, 
but actually putting the letters A-Z and numbers 0-9 
on screen in our game when we want it, at the right 
point, in the right colour, in the right size... no, that’s 
not actually easy at all. 

Text is funny stuff when displayed on screen. It 
comes in all kinds of shapes and styles, called fonts, 
all kinds of sizes, all kinds of emphasis. Even within 
a font there are all kinds of issues with the width of 
different letters. Consider W and I; W is one of the 


The Top Left 


worked out 


Corner can be 


Me have a fixed X distance to 
call the edge of the screen 


9 
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_|_ | fe 


We have a fixed Y distance to E ll sll al call all Zz al 


the top, if we have X and Y 
distances we can work out the 
top left corner with ease 
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MagPiHelloTriangle. 
cpp 
SimpleObj.h/cpp 
Game.h/cpp 
OGL.h/cpp 
Bob.h/cpp 
HideAndChase.h/ 
cpp 
PointToPoint.h/cpp 
Input.h/cpp 
Text.h/cpp 


DOWNLOAD: 
magpi.cc /MzGDri 


Figure 4 Here's a 
very simple font 
display using an 
on-board font 


widest letters in the Roman alphabet, I is one of the 
thinnest, but we want a word like WIDTH to keep 
the letters close together. We call that proportional 
Spacing, where we keep the gap between letters toa 
comfortable minimum. W I DTH just looks wrong. 

We could just treat text like a sprite, keeping a 
suitable drawn tile for each letter and number in a fixed 
order which matches the standard ASCII character set 
system (A = 65, B = 66, etc.). But though simple, it’s 
rather an inflexible system and the font is also going to 
be a fixed size, so we have to make adjustments when 
drawing to keep the proportional spacing we desire to 
look good and if we want to use a different font, we may 
have to store new info on spacing. 

Oh, and we mentioned the Roman (also called Latin) 
alphabet — that’s the standard English alphabet — but 
there are several others: Cyrillic, Kanji, Arabic, etc. 
There has to be some kind of standard, though, which 
computers can use to display the same text in any 
chosen font or emphasis! The most common is the 
TrueType standard, which keeps all the data needed 
to proportionally space our letters, and info on any 
emphasis systems we want to use. 

There are many sites where you can download 
free to use TrueType fonts — a quick web search for 
free TrueType fonts will find dozens of sites you can 
browse for just the right font you want, but make sure 
it’s free to use. Once you download it, treat it like any 
other asset and load it as you need it. 

So, to repeat, printing text is not easy, not easy at 
all... it’s such a lot of work in fact, it’s in our interests 
to make use of code that’s been written by far more 
experienced people who actually enjoy working with 
such demanding tasks. 

There are many font-handling libraries around, 
some you have to pay for, but most are free. We’re 
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going to use acommon free one that’s already on our 
Raspberry Pi, called FreeType. It’s fairly simple to use 
and once we have included the relevant files, we can 
let that library take the strain. 

Review the new Text class, which lets us use the 
FreeType lib in easy-to-understand ways. We also 
have a fair number of pre-installed fonts we can use; 
our demo will use what’s available on your Raspberry 
Pi. Just add /usr/include/freetype2 to your #include 
file list, and the library itself is called freetype. 

Now that we can print text, we can also use it to 
report on values in the game. Since our debugger is 
not so easy to use now, we are full-screen — but we’ll 
come to that soon, as we’re going to start holding back 
a little on providing fully working code so you can 
write your own. 

There are some interesting new concepts in our text 
shader and setups, not least of which is their use of a 
mathematical concept called a matrix. Now, these are 
truly wonderful things which have a tendency to scare 
beginners, but really all a matrix does is allow us to 
do all the maths we do in our current hacky shaders 
much faster. We’re going to discuss this properly in 
the next lesson. 


Next time 
Our main core of the game is done, but we don’t have 
a very organised game: there’s no intro; no menu; 
only one, rather bad level; our jumps and timing need 
tweaking; and we don’t as yet interact with other 
objects. Next time, we’ll correct these and add pick- 
ups and a Score system, as well as introducing some 
concept of losing lives and game over. 

We’ll also take our first important steps in 
using matrices, and take a bit more care of our 
asset management. 


LEARN 
MORE 
ABOUT C 


Brian has a 
whole book 
on the subject 
of making 
games C and 


C++, called The 
Fundamentals 
of C/C++ Game 
Programming: 
Using 
Target-based 
Development 
on SBCs. Grab 
it here: 
magpi.cc/ 
nUkjEt 


PIMC Pres 


THE FUNDAMENTALS of 


o/ C++ GAME PROGRAMMING 


Sing Target-based Development on SEC's 
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Tutorial 


_ JONATHAN PALLANT 


a A professional embedded systems 


The cargo new command creates a new Cargo automatically programmer based in Cambridge, Pi 
Rust crate. The --bin argument makes re-compiles your code Wars veteran, and member of the Rust 
it a program, not a library when you try to run it Embedded Working Group. 


keybase.io/thejpster 


Ae cargo new --bin my_test_program 
2d binary (application) my_test_program project 
pberryp1: cd my_test_program/ 
berryp1: cargo run 
] my_test_program v0.1.0 (file:///home/pi/my_test_program) 
Shed dev [unoptimized + debuginfo] target(s) in 7.51s 
inning target/debug/my_test_program. 


Hello, world! 
SCY es Npeenrep emma Figure 1 A newly created Cargo crate 
PiWraspverrypl. i contains a Hello World example program 


READING SENSE 
HAL DATA WITH 


Want to learn a new programming language that’s ergonomic and safe, 
yet runs really fast? Dive in to Rust 


e’ve all heard about security bugs in programs 
written in C, a language that dates back nearly Installing Rust 
rust-lang.org 50 years. Yet it remains the default choice for Rust is fairly straightforward to install and has native 
> Sense HAT systems programming. In Rust, anew programming support for the ARM processor in the Raspberry Pi. 
magpi.cc/ language from Mozilla, it’s almost impossible to If you visit rust-lang.org and select Install Rust, 
eo introduce security flaws, yet the compiler produces it will prompt you to run the following command: 
fast machine code. To introduce you to Rust, we’ll walk curl https://sh.rustup.rs -sSf | sh. This 
through the installation of the compiler and a simple will download and run the installation script, detect 
example program for the Sense HAT. your Pi, and fetch the correct version of the compiler 
automatically. Just follow the on-screen instructions. 


@ @ 
listing!.rs | 
Create and run your first program 


// Here we access the crate we specified in Cargo.toml. Rust programs and libraries are called ‘crates’ and are 
extern crate sensehat; built using a tool called ‘Cargo’. Let’s ask Cargo to create 
a new ‘binary’ crate with a bare-bones example program 
// The use statements pull some types into scope, to inside, using the cargo newcommand (see Figure 1). 
// save us some typing. You can give your new program any name you like, but 
use sensehat: :SenseHat; make sure you use underscores instead of spaces. We 
can then enter the new folder that has been created and 
// main() gets called when we run our program ask Cargo to run our program. Cargo correctly works out 
fn main() { that our program must be re-compiled before it can be 


// The variable 'hat' represents our SenseHat. We mark 
// it mutable (otherwise it would be const, or read-only). 
let mut hat = SenseHat: :new().unwrap(); 

// Get the temperature and unwrap the result. 

let temp = hat.get_ temperature from _humidity().unwrap(); 
// Tell everyone how hot it is using the println! macro. 
prantin!( {} , temp); 


J This is what listing1.rs should look like when you run it. 
9g y 
This library defaults to using kelvin for temperature 
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READING SENSE HAT DATAWITH RUST | Tutorial 


run and takes care of that for us. Compiling our code 
checks it for correctness and then converts it from the 
source code into a machine code file the computer can 
run, so it’s harder for bugs to hide in Rust, unlike Python 
where each line isn’t checked until it’s executed. 


>STEP-03 

Fetch some crates 

Rust gives you access to a range of software crates 
written by other Rust programmers, at crates.io. By 
making changes to our crate’s Cargo.toml file, we can 
tell Cargo we’d like to make use of one of these crates 
in our program. This saves us a bunch of typing, but 
it’s often better to build on the work of others. Edit 
the Cargo.toml file in your project’s folder in your 
favourite text editor (such as Geany) to add this line, 
under [dependencies]: 


sensehat = "1.0" 


Next time you build your code, this will pull in version 
1.x (anything compatible with 1.0) of your author’s 
Sense HAT driver from magpi.cc/issfxz. Because we 
used some other crates when writing this driver, when 
you next build, Cargo will automatically pull all of those 
in as well, and all the crates they need, and so on. 


>STEP-04 

Reading from the Sense HAT 

Our program lives in a file called src/main.rs. Let’s 
load that up, delete the ‘hello world’ example placed 
in there by default, and do something with our Sense 
HAT by copying the code in listing1.rs. We can run 
this again with cargo run and it should look like 
Figure 2. Don’t worry, it will only take a while to 
compile the first time around. 


>STEP-05 

Let’s loop 

Rust has all the usual programming language features 
like for loops and if statements. Let’s expand our 
program to wait until someone shakes our Pi, using the 
accelerometer function, and then print them a message 
on the LED screen — see listing2.rs and Figure 3. 


>STEP-06 

Read the docs! 

Hopefully we’ve given you a little taste for the Rust 
programming language and shown that it’s not much 
more complicated than Python or JavaScript. For 
further reading you can check out the Rust Book, 
which is available for free online at magpi.cc/HAoyYu, 
or as a printed copy from your favourite book vendor. 
If would like to do some experiments with LEDs and 
buttons, check out Rahul’s excellent port of GPIO Zero 
to Rust at magpi.cc/eYpDfk. You can also read the 
documentation for the sensehat crate, to find what 
other features it has to offer, at docs.rs/sensehat. 
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listing2.rs 


// Here we access the crate we specified 


in Cargo.toml. DOWNLOAD: 


extern crate sensehat; magpi.cc/apkZUw 


// The use statements pull some types into scope, to 
// save us some typing. 

use sensehat::{Colour, SenseHat, SenseHatError}; 

use std::{thread::sleep, time: :Duration}; 


// We've declared main as returning a Result, which 
// means we can use the ? operator to bail out early 
// if our code finds any errors at run-time. 
fn main() -> Result<(), SenseHatError> { 
let mut hat = SenseHat: :new()?; 
let temp = hat.get_ temperature from _humidity()?; 
println! ("It's {} in here", temp); 
// Clear the screen 
hat.clear()?; 
// Instructions for the user 
println! ("Shake me!"); 
loop { 
// Get the G readings from the sensehat 
let accel = hat.get_accel raw()?; 
// Show them on screen in debug format. 
println!("{:2}", accel); 
// Check if any acceleration value is too high 
if [accel.x, accel.y, accel.z].iter().any(|g| *g > 1.5) { 
// If so, print a warning message! 
hat.text("Earthquake!", Colour: :WHITE, Colour::RED)?; 
// Pause on the final character 
sleep(Duration: :from_millis(100@) ); 
// Turn the screen off 
hat.clear()?; 
} 
// Let our CPU rest for a short while to slow down 
// the output. 
sleep(Duration: :from_millis(250)); 
// Press Control + C to quit this loop! 


Figure 3 This Rust Sense HAT driver 
uses the same RTIMULIib C++ library as 
the Python Sense HAT driver 
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YOUR QUESTIONS ANSWERED 


FREQUENTLY 
ASKED QUESTIONS 


NEED A 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 


Your technical hardware and software problems solved... 
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PROGRAMMING ON PI 


Basics with Scratch 

Depending on your skill level, the easiest entry point 
is Scratch. It uses programming blocks that you drag 
and drop with your mouse to create code you can 

see — this teaches you the basic structure and logic of 
coding, while also letting you see instant results for 
what you’ve done. 


Learning code 

The step above Scratch is actually typing out code in 
something like Python. It’s quite easy to read and 
understand and, like Scratch, lets you see the results 
of your work pretty quickly. You can find lots of 
Python tutorials in The MagPi’s archives and on the 
Raspberry Pi projects site: rpf.io/projects. 


Programming objects 

Once you’re confident enough with making programs 
in Python, you can then graduate to controlling 
different components and reading from sensors. This 
can be as simple as turning on an LED hooked up to 

a Pi, or more complex, like recording environmental 
data to control a robot. 


IDLE 

IDLE is the default IDE (integrated development 
environment) that comes with Python. It lets you 
write your code and test it quickly without having to 
compile it into software. It offers basic debugging 
of your code, and it’s a lot better than just typing 
something into a text document. 


Thonny 
Thonny comes with Python 3.6, and has been 
developed to be a lot easier to use for beginners 
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compared to IDLE. It includes the shell and code in 
one window, and gives you info on variables in extra 
columns around the interface — almost everything 
you'll need to know at a glance. 


Mu 

Designed for true beginners in mind, this new option 
is meant to be the first Python IDE to use. It offers 
specific modes to make coding your project easier — 
you can select standard Python, or even a Pygame Zero 
mode to make some games with. 


Anything you desire! 

All modern programming languages are available to 
use on the Raspberry Pi, such as C, C++, Ruby, and 
JavaScript. You may need to install extra software to 
truly get the most out of them, but a quick Google 
search will help you there. 


Node-RED 

This programming language uses Node blocks to 
create code, somewhat similarly to Scratch, albeit 
designed with creating the code as a workflow. 
It’s very powerful and has been used to animate 
dinosaurs, hack Minecraft, and much more. 


Wolfram Mathematica 

Wolfram and Mathematica are supplied for free in 
Raspbian and allow you to do some serious coding 
with access to a lot of data. We’ve seen them used for 
wonderful graph plots that look like pieces of art, as 
well as making it simple to mod Minecraft Pi and post 
to Twitter. 


® python 
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WHAT IS THE USER NAME AND PASSWORD 

FOR THE RASPBERRY PI? 

The default user name for Raspbian is pi and the default 
password is raspberry. If this does not work, check the 
information about your specific operating system on the 
downloads page (magpi.cc/1MYYTMo). 


WHY DOES NOTHING HAPPEN WHEN I TYPE IN 

MY PASSWORD? DID MY RASPBERRY PI FREEZE? 

To protect your information, Linux does not display 
anything when you are entering passwords in the Bash 
prompt or the Terminal. As long as you were able to see 
the user name being typed in, your keyboard should be 
working correctly. 


HOW DO I CONNECT A MOUSE AND KEYBOARD? 

The Model A/A+ has one USB port, the Model B has two 
ports, and the Model B+, Pi 2 Model B, and Pi 3 Model B/ 
B+ have four ports. These can be used to connect most 


Having trouble with The MagPi on the App Store or Google Play? 


Here are your most common questions answered. 


How do | find The MagPi on Google Play or the App Store? 
All you have to do is go to the search bar and type ‘The MagPi 


or ‘Raspberry Pi' to find us. 


I've subscribed to the digital edition and I can't sign in 


to restore my purchases. Please help! 


USB 2.0 devices. Additional USB devices such as mice, 
keyboards, network adapters, and external storage can 
be connected via a USB hub. The Pi Zero and Pi Zero W 
have a single micro USB port; this requires a USB OTG 
cable to connect devices such as keyboards or hubs. 


WHERE IS THE ON/OFF SWITCH? 

There is no on/off switch! To switch on, just plug it in. 
To switch off, if you are in the graphical environment, you 
can either log out from the main menu, exit to the Bash 
prompt, or open the Terminal. From the Bash prompt 
or Terminal, you can shut down the Raspberry Pi by 
entering sudo halt -h. Wait until all the LEDs except 
the power LED are off, then wait an additional second 
to make sure the SD card can finish its wear-levelling 
tasks and write actions. You can now safely unplug the 
Raspberry Pi. Failure to shut the Raspberry Pi down 
properly may corrupt your SD card, which would mean 
you'd have to re-image it. 


MagPi = 


RUN ANDROID 
ON RASPBERRY PI 


» Use Android Apps » Build Touchs< ol Electro 


MAKE YOUR OWN 
OSCILLOSCOPE 


MAGIC: THE 
GATHERING 
CARD COUNTER 


BUILD A 
WILDLIFE CAMERA 


HERE COMES 
2 THE SUN 


Since your The MagPi purchases are linked to your Google or Apple S/S air 


accounts, there's no need to sign in at all. If you'd like to re-download 


+ GLOBAL |!» 
© eee 


your purchases on your current device, or make your purchases 


available on other devices, all you need to do is hit Menu on the home 


screen, then Restore Purchases on the sidebar. 


How can | search the digital magazine for keywords? 


Finding direct references is really easy with The MagPi app - 


GET IT ON 


>> Google Play 


all you have to do is tap the screen to get the app's GUI to show, 
and then press the small magnifying glass icon in the top-right 4 Available on the 


corner of the screen. Now, just type in your search term to find the 


relevant results. 
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§ App Store 
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SECURE 


OUR HOME 


WITH RASPBERRY PI 


MAKE YOUR HOUSE SAFER WITH THESE SIMPLE PI PROJECTS 


ome security is important. Whether you live home or not. Over the next few pages we’ I delve into r @ 

in a high-crime area or are currently at a bad these kind of projects that you can make much more ow 
time in your life, feeling safe in your own cheaply than a home security system. | 
home is essential. The Raspberry Pi can help you here. Of course, you could also use all of the above to keep P 
With the rightt tools you can set up a CCTV an eye on your cat during the day, or make sure you hear a 


network. Or have a special doorbell that lets you know _ the postman. However you want to use it, make sure to 
whenever someone is at your door, whether you’re at have a spare Raspberry Pi handy, and let’s get started. 
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SECURE YOUR HOME WITH RASPBERRY PI Meg@el (IIx 


@ Unlocked 70% 62% mm) 


14:59 


ele wes ey = Wednesday 18 July 
NETWORK 4 
PUSHOVER 

a 

Door opened! 

The door is open! 


DOOR 
SECURITY 
MONITOR 


AMAZON 
DASH BUTTON 
DOORBELL 
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RASPBERRY Pl 


NETWORK 


Combine multiple Raspberry Pi boards and their Camera Modules 
to create a home CCTV network using motionEyeOS 


ome CCTV systems and IP cameras are 

becoming increasingly popular nowadays, but 

can be expensive to buy and install, especially 
for multiple cameras. In this guide, we’ll show you 
how to use multiple Raspberry Pi boards and their 


Camera Modules to create a home CCTV network using 


motionEyeOS, so that you can keep an eye on your 
home at all times. You can even be alerted whenever 
any of your cameras detects movement, so that you 
never miss anything! 


Every camera you want to include in 
your Raspberry Pi home CCTV network must 
be running motionEyeOS. Download the image 
based on the Raspberry Pi model you are using 


ETCHE Srosnic 


First things first, downers ——— 


motionEyeOS and flash it to 
your microSD card. We like 
Etcher as it’s quick and easy 


1OOOCSUEODLO! |" mMaS0O08D8:'00 SBTOH. I 


Preconfigure your WiFi access by 
creating a wpa_supplicant.conf 
file that is placed in the boot 
partition of your microSD card 


and then flash it to the microSD card. We love 
using Etcher as it is simple to use and works 
with compressed image files, but you can 

do this any way you like. Don’t boot your Pi 
just yet, though, as we need to preconfigure 
the WiFi connection. 


l ‘(>t |b 

If you are running motionEyeOS on 
a Pi Zero W, you will need to preconfigure the 
WiFi connection before booting for the first 
time. Using a text editor, create a file called 
wpa_supplicant.conf, then add your network 
credentials (more information can be found here: 
magpi.cc/BrUXgR). Save the file and then copy 
it to the boot partition on your Pi’s microSD card 
— we will reuse this file for the other Pi boards as 
we add them, to save repeating this every time. 


We’ ll use the first Pi as our ‘master’. The first 

boot can take longer as motionEyeOS will 
optimise the microSD card. Access the motionEyeOS 
interface by going to the Pi’s IP address, where you 
should be greeted with a login prompt. Use admin as 
the user name; the default password is blank. 


Repeat Steps 1 and 2 on each additional Pi 

you want to add. They should all be running 
motionEyeOS, be connected to WiFi, and you should 
be able to access motionEyeOS on each using its IP 
address — if not, double-check that you added the 
wpa_supplicant.conf file to the boot partition and try 
again. Now log back in to the ‘master’ CCTV Pi and 
click on the three horizontal blue lines in the top-left 
corner. Next to that is a drop-down menu ~— select 
‘add camera’ and in the Camera Type, select ‘Remote 
motionEye Camera’. Enter the remote camera’s IP 
address, user name (admin), and password (blank), 


and you should be able to select the camera. Do this The official Pi Zero Case 
— is perfectly suited to the 
for each additional camera you have set up earlier. CamermiModile 


A wide-angle lens 
is inexpensive and 
Once you have added your cameras to the enhances the field 


; f vi th 
‘master’ CCTV, you should see them in the live view 7 ae - eee 
on motionEyeOS accordingly. Congratulations! Now 
you can customise and configure each camera from 
‘ : The Pi Zero W is 
the ‘master’. You may want to name each camera, as a great choice 
well as tweak the resolution, or even add email alert due to its size 
nS AS and wireless 
notifications when motion has been detected. Your capabilities 


home CCTV system is now complete! 


pV/192.168,0.87 


Add Camera... 


Camera Type Remote moctiontye Camera 
URI 
Username 
Password 
Camer 


sdmin 


Cancel 


Add your additional remote 
motionEyeOS cameras using their 

IP addresses, user names (normally 
admin), and passwords (normally blank) 


The magnet is 


DOOR 


MONITOR 


Connect magnetic door security Switches to or closed and receive notifications via motionEyeOS 

: : Ca : and Pushover too? In this guide, we will show you how 
your Raspberry Pi and receive notifications ost that 
when they are opened, via motionEyeOS 


opefully, you saw how simple it is to 


use multiple Raspberry Pi cameras with m Before you connect everything to the 
motionEyeOS to create a home CCTV system door or window you want to monitor, it is best 

J in the last guide. Why not go one step further by using to test the circuit first. Use a breadboard and 
the Raspberry Pi’s GPIO to monitor simple magnetic connect a jumper jerky cable to the 3V3 pin on 

oo reed switches to see whether a door or window is open the Pi and the positive rail on the breadboard 


PERE EEE EEE ETE SG 


Connect one end of the 


switch to the 3V3 pin on 
coee clases dias the Pi's GPIO 
td] eeoveevesee ges 
= eoeoeeeeee eos 
* ee CSCC COEOCEOS 
. 
a | 
a 8 eee eoeeees eoeoeoeoeoeveeeeeeeeeeee 
ef eeee eeeeeweeeveeneeeeeeeeeeeeeees 6 
a 8 ee 8 == me e©e©eeeeeeeeeeeeeeee ee 
s * eeeeeeevpvpeeeweweeeeeeeeeeeeeeeeee 
es sf peooeseoooeoeeveeeeee ee eee ee lt 
- Le! 
(VN3SWVD) ISd sf 
= a F 
sf 
nm 8 


Es: 
® 


ETHERNET 


A magnetic door security 


The other end of the switch is essentially 
switch is connected to a reed switch that's 
\J \J \J \J physical pin 10 (BCM15) triggered by a magnet 
Oi ee —_ 
—————————————————— 


— like our diagram. Connect another to GPIO physical 
pin 10 (BCM 15) and the negative rail. You can then 
connect the magnetic switch to the positive and 
negative rails — it doesn’t matter which way here. 


eT ‘ PehY 
You’ ll need to create a Pushover app for this 
to work. There is a seven-day trial, and it’s 
$4.99 / £3.83 for a licence. Head over to pushover.net, 
log in, and then create an application. Give ita name 
(Door Monitor) and upload an icon — there’s one in our 
source code if you want to use that! You will then get 
an API Token / Key, and you can find your user token 


on the main screen. Keep these safe! 


LTE THE CODE 
Unlike Raspbian, motionEyeOS does not 
allow you to clone GitHub repositories easily. The 
quickest way is to SSH into the Pi (usually as root) 
and then navigate to the /data/etc directory and type 
nano monitor_1. The file does not need an extension 
and the number has to match the camera ID it will 
work with. Now add our code, replace the app and user 
tokens for Pushover, then save and exit. Lastly, run 
chmod +x monitor_1 to make the script executable. 


By now, you should have prototype circuit, 

| a Pushover app, and have added our 
code to your Pi running motionEyeOS. If you have 
motionEyeOS open in your browser, reload the page 
first as this is required. Next, click on the image of the 
camera feed and you should see the word ‘Closed’ in 
the bottom-left corner of the screen. If you break the 
circuit — i.e. pull the magnet away from the switch - 
this should change to ‘Open’ and you should receive a 
Pushover notification. 


“WL. Now that we know the switch and code work, 
you can disassemble your prototype circuit 

and install it all properly. It’s worth powering off your 
Pi first, though. The magnet part of the switch should 
go on the door/window itself, and the switch part 
should be on the frame — there are normally installation 
instructions supplied with the switch as well as screws 
etc., for mounting correctly. Once complete, boot up the 
Pi and everything should be working properly. 


outdoor-camera 7:3/4-9 # 


Outdoor Camera 


Our code displays a simple ‘Open’ or 
‘Closed’ message on the camera feed 
in motionEyeOS, as well as in the Pushover 
notification. You can easily change this by 
modifying the relevant parts in our code. By 
default, and to prevent you from being spammed 
with repeated Pushover alerts, we’ve set our 
code to run every 300 seconds (5 minutes). You 
can also tweak this, but we found it to be a good 
time period. 


@ Unlocked FOR 62%) 


14:59 


Wednesday 18 
wine, ddan 


@ Door opened! 


The door is open! 
Open http: //IP.AL 
(4 PUSHOVER 


Door opened! 
The door is open! 


wlEES 14:59 


Left In 
motionEyeOS, 
you can see the 
status of the door 
in the bottom- 
left corner when 
you click on 

the image - it is 
closed here 


Below You can also 
receive Pushover 
alerts when a door 
has been opened 

- handy for when 
you're not home! 


€ Door Monitor Door Monitor 


AMAZON DASH BUTTON 


Want to do more with the Amazon Dash Button apart from ordering shopping: 
Put it to good use and make your own IoT doorbell 


he Amazon Dash Button is a cheap, hackable 
internet-enabled device that was designed 
to order shopping online with a push. Whilst 


this is a great idea, why not make the Dash Button do 


something more constructive by creating your very 

own IoT doorbell using Pushover notifications and 

a Raspberry Pi? In this guide, we’ ll show you how to 

do exactly that so you can be alerted to visitors even 
: when you are away from home. 


Once pushed, the Dash 
Button triggers a Pushover 
notification on your 
smartphone or tablet 


The LED status light will 
pulse white when pushed 
- the red flash can safely 
be ignored 


The button can 

be simply stuck to 
the frame with the 
supplied adhesive 


Before you can use the Dash Button, 
you will need to start the process of setting 
up the button on Amazon. Follow the steps 
outlined here (amzn.to/2mNhAqt), but stop 
and exit the app before you choose the product. 
It’s important to do this otherwise you could 
order products! Next, you’l] need to find the 
MAC address of your Dash Button - this is 
unique to your button and identifies it online. 
Read our previous tutorial on how to do this 
here: magpi.cc/2rwtTxP. 


You’ll need to create a Pushover 

app for this to work. There is a 
seven-day trial, and it’s $4.99 / £3.83 fora 
licence. Head over to pushover.net, log in, 
and then create an application. Give ita name 
(Dash Doorbell) and upload an icon — there’s 
one in our source code if you want to use that! 
You will then get an API Token/Key, and you 
can find your user token on the main screen. 
Keep these safe! 


Clone our Python code from 
GitHub with: 


git clone https://github.com/ 
raspberrycoulis/dashdoorbell. git 


...and then you will need to make a few 
simple edits to get this up and running. 


Dash button (Application) Back to Apps 
API Token/Key (Edit or Delete Application) (8 
To begin using our Al" to send notifications, use this application's AP toler: 3 
Subscription (Edit Subscription Settings) 


This application has not activated user subscriptions. Create a subscripts to alow users 10 subscribe. 


Licensing Credits (Purchase License Credits) 
This application Goes not have any Scensing credits. 


% get started with our ) AP! to aseign device ioenses to your users, you can 


Recent Usage (Upgrade Message Capacity) 


30 messages have been sent out of 7,600 allowed this month 


Create your Pushover app and then grab your user and API token 
keys. Why not use our app icon in the source code? 


Alternatively, you can type the code yourself using 
your favourite code editor, but cloning is a lot quicker! 
Assuming you are in the dashdoorbell directory, run 
nano dashdoorbell.py to edit the code, replacing 
the MAC address, app and user tokens where shown, 
then exit (CTRL+X) and save (Y) to keep the changes. 


Before you affix your Dash Button to your 
door frame, you might want to just check 
that everything works as it should. After you have 
added your MAC address, app, and user tokens in 
the previous step, you can test the Python code 
by running sudo ./dashdoorbel11. py in the Pi’s 
Terminal. You won’t see anything in the printout, but 
push the button once or twice and you should get a 
Pushover notification on your smartphone or tablet! 


SOL = alee > 13:25 
< Back Dash button 


1 2 TL | je Doorbell! 
. 
. There's somebody at the door! 


ednesday 1 


wlEE > @ Unlocked 


View Link 


now 
There's somebody at the door! EP 


Press Home to open 


eed 


e dashdoorbel. py — -/githud/dashdoorbell-github 


» «= DASH_BUTTON_MAC 


7 APP_TOKEN * ADD. 
) USER _ TOKEN ‘ADO YOURS KE 


f ver(): 
conn © Mttplid. MTT 
conn. request ("POST” 


tion("api.pushover.net:443") 
, “/l/messages. json", 


somebody at the door!", 
egal You'll need 
}), { "Content-type": “application/ X-Ww-form-urlencoded” }) to add your Dash 
tresponse() Button’s MAC address 
and Pushover user 
and application 
tokens to the 
dashdoorbell.py 
script before it ll work 


ip_filter(pkt): 
' pkt.hesleyer(DHCP): 
options pkt (DHCP) .options 
for option options: 
t (option, tuple) 


Now everything is working, you can 

install your Dash Button wherever 
you want it. The button comes with an adhesive 
sticker on the bottom, so you can just use that to 
affix the button, but please keep in mind that this 
is semi-permanent and also remember that Dash 
Buttons are not waterproof! You could also put it 
on your bedroom door to stop your nosey parents, 
sister, or brother coming in unannounced. 


The default message in our code is 
basic and just tells you that ‘There’s 
somebody at the door!’ with the title ‘Doorbell!’. 
However, if you want to you can easily change this 
to whatever you like by editing the relevant parts 
in the dashdoorbell.py code. Using the Pushover elow Why 
: : not create your 
API is very simple, and well documented over at own label? Just 
pushover.net/api, but feel free to experiment. poem cos one 
You can even change the sound by changing the 


off and use the 
template in the 
appropriate part in the code! 


source code to 
create your own 


If set up correctly, when you push 
the Dash Button you should receive 
a push notification that tells you 
somebody is at the door! 
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STRATO PI CM 


Need a robust housing/motherboard for your Raspberry Pi Compute Module? 
Brian Corteil gives the Strato a spin 


he Strato PiCMisa 
housing/motherboard 
designed for all versions 
of the Raspberry Pi Compute 
Module (CM) and is from a line of 
industrial products for the Pi/CM 
from Sfera Labs. The Strato Pi CM 
can be supplied with or without a 
Compute Module. 

Designed for the IoT market, it 
enables a Raspberry Pi to interface 
with industrial equipment/sensors 
to the internet. Possible roles 
for the Strato include collecting 
sensor/diagnostics data, as a web 
interface to the collected data, 
to bridge old equipment via its 
RS-485 port to the internet, and 
for a webcam CCTV network video 
recorder (NVR). 
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Opening the box, we found 
a standard two-gang DIN 
module that can be mounted to 
a DIN rail type normally used 
in electrical distribution boards 
and industrial control panels. 
The removable connector block 
is clearly labelled along with the 
LEDs on the front panel. On close 
inspection, the module has an 
RS-485 interface, two USB ports, 
and an Ethernet port. Other 
features include 9 to 28V DC 
power voltage, a real-time clock, 
controllable LED, and a hidden 
push-button. 

Obtaining access to the PCB 
proved very simple: you just need 
to remove the DIN rail retaining 
clip, power/RS-485 block and, 


using a small bladed screwdriver, 
the PCB is exposed. There are 

a couple of new interfaces: a 
micro USB port for programming 
the CM, and a microSD holder if 
you are using a CM Lite board and 
the hidden button. 

Your reviewer handed the 
Strato to friendly electronic 
engineer and fellow Makespace 
member Rob Karpinski for his 
view of the construction and 
design. Having given it a once- 
over, he said that it was well 
made and that the RS-485 inputs 
were well protected. When told 
the cost of the unit, he choked 
a little but did say that it was 
expected for a device designed for 
industrial use. 
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Sfera Labs sent the Strato Pi CM 
Solo for review; this version does 
not come with a CM, but installing 
one is easy: just line it up and push 
down until it clicks. The next step 
is to install Raspbian. Reading 
the included Quick Reference, we 
were pointed to the user guide 
on the Sfera Labs website and 
then instructed to follow the 
euide on the Raspberry Pi site - 
magpi.cc/UtAcOj. We followed the 
guide and used the micro USB port, 
the user guide did not mention that 
the Strato had to be powered at 
the same time to install Raspbian 
Stretch Lite on the CM eMMC. We 
remembered to include a file called 
ssh to enable remote access and 
then connected to the Strato via its 
Ethernet port using PuTTY. 
Following the user guide, we 
installed the Strato Pi utility and 
the software supporting the real- 


STRATO PI CM 


From £264 / $290 


test equipment box. Using PuTTY 
on the PC, we were able to access 
the CM’s console and use the 
command line as normal. With the 
correct cable, this means we could 
use the console or have sensors/ 
equipment installed up to 1000 
metres away. 


mT. es 


eaB5 


Niche market 

The Strato Pi CM is for a niche 
market that requires the 
versatility of the Raspberry Pi in 
a small compact format that the 
Compute Module allows, and the 
professional user requires. The 
build quality is excellent and with 
a well-thought-out design. The 
inclusion of a real-time clock, 
isolated RS-485 serial interface, L 
LED, and button, plus the wide 
range of voltages the Strato Pi 
can take for its power input, are 
its strengths. Adding all these 


The build quality 1s 
excellent and with a 
well-thought-out design 


time clock. We played around with 
the utility, turning on/off the LED, 
and restarting the CM using the 
watchdog feature — although it 
turns out you don’t need to use 
the utility to access these features 
or the button. 


Test script 

After installing the GPIO Zero 
Python library, we wrote a simple 
script to flash the LED every couple 
of seconds for ever. This script has 
now been running for over 14 days; 
the Strato module has been sitting 
in your reviewer’s garden office 

/ toy room, in temperatures over 
35°C with no issues. 

Next thing to test was the 
RS-485 serial port. Luckily, we 
had an RS-485 to RS-232 anda 
serial-to-USB converter in the 
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functions to a standard Pi would 
require the use of several HATs 
stacked on top of each other. Your 
reviewer would personally like to 
see some GPIO pins broken out 
from the Compute Module with 
the same protection as the RS-485 
port, to allow the adding of I?C, SPI 
devices, sensors, and extra LEDs 
and buttons. 


fast word 


If you need the power of 
the Raspberry Pi 3 Compute 
Module in a compact industrial 


case with an RS-485 interface, 
we don't think you would go 
wrong with the Strato Pi CM. 


Right Why stack 
HATs when you 
can just use this? 
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Maker 
says 
A high- 
resolution, 
high-speed 
4.0° TFT 
display 
for your 
Raspberry Pi 


Pimoroni 


£40/$51 


HY PERPIXEL 4.0 


Rob Zwetsloot looks at this bigger touchscreen for your Pi that is still palm-sized 


OFFICIAL 
TOUCH 
DISPLAY 


A larger screen 
at the same 
resolution as the 
HyperPixel 4.0, 
its size may 

be more 
attractive for 
some projects. 


j = 5 
CUR F rrr 
——————————— 


£60 /S$76 
magpi.cc/2mftBGX 


t was only last year that 
we reviewed the 3.5-inch 
HyperPixel from Pimoroni, 
itself a fantastic touchscreen 
offering great pixel density ina 
diminutive, Pi-sized form factor. 


This new, bigger HyperPixel model 
keeps the same high-quality parts 
but gives you more screen real 
estate to work on. 

The larger size does mean that it 
doesn’t fit within the confines of 
the (standard) Raspberry Pi form 
factor, with a good chunk of the 
screen hanging off the SD card side 
of the board. It’s really not that bad, 
but it does mean if you have any 
cases that previously allowed you to 
squeeze in the 3.5-inch HyperPixel 
or other displays, it likely won’t 


74. | MadgPi September 2018 


work with the new HyperPixel. It’s 
an interesting dilemma as, due 

to the existence of stuff like the 

A+ and the Pi Zero, the standard 
Model B form factor is not as 
ubiquitous as it once was. If the old 


The screen 1s super-lovely once 
working — crisp and clear visuals 
thanks to the pixel density 


3.5-inch screen would outsize a Pi 
Zero, then why not make it a little 
bit bigger anyway? 


One-line install 

As usual, this bit of Pimoroni kit 

is really simple to install. All you 
need to do is attach the screen 

to a Pi, hook the latter up to the 
usual monitor and keyboard 
arrangement before turning it 

on, and then enter a one-line 
command in the Terminal to get all 
the software properly installed. It 


doesn’t take long and you’ ll then 
be immediately ready to go! 

The screen is super-lovely once 
working — crisp and clear visuals 
thanks to the pixel density, with 
responsive touch controls and wide 
viewing angles due to the display 
tech used. It’s basically everything 
you’d want from a screen, and the 
Raspberry Pi can handle it just fine. 

If the touchscreen controls 
aren’t a necessity, you can get 
a HyperPixel without them and 
save a few quid (and probably a bit 
of power draw). Either way, it’s 
another top Pimoroni product. 
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A beautiful screen that's easy 
to install with a responsive 
touchscreen perfectly suited 


for every Pi with 40-pin GPIO. 
What more could you ask for? 
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RASPBERRY PI 
ROBOT KITS 


Make the perfect Raspberry Pi automaton 
with these excellent robot kits 


he Raspberry Pi 
has helped create a 
new boom in hobby 


robotics, largely thanks to its This fantastic, simple kit has been 
price, easy hackability, size, around for a while to promote Pi 
and a great community willing Wars, the annual Raspberry Pi 

to share their robot expertise. robot challenge. It includes all 

It’s never been easier to join in the basic stuff you need to create 
yourself, thanks to a plethora a robot — all you need to do is 

of robot kits for the Pi. Here supply your own Raspberry Pi! 

are ten of the best, in no You can even use the box as the 
particular order. robot’s chassis. 


A more beginner-friendly PiBorg kit compared to 
ae the DiddyBorg, the YetiBorg is a smaller design that 
is perfect for people relatively confident in their 
coding skills who want to apply them to something 
physical. It’s also used in the Formula Pi racing 
—. Ja series, where automated robots compete against 
¥ each other using code from teams around the world. 


me/edukit 


RaPiRo 


Cute biped 


This adorable robot may be While all the robot kits here can be made autonomous, 
on the expensive side, but it’s this kit is one of the few that comes with all the 
unusual for a Raspberry Pi robot equipment you’ll need to make it so from the start. It 
™ as it walks. And waves at you. has a line sensor, an ultrasonic distance sensor, and 
“2 Construction is a bit tricky, voice recognition. You can even program it in Scratch. 


and coding is trickier 


ne) still, but once you have 
it walking around 


F and interacting 
with things, it’s all 
| well worth it. 


—_ ~h 


% 
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Tiny 4WD 


Competition ready 


This robot kit from maker Brian 
Corteil is based on a robot- 
building feature he wrote way 
back in The MagPi #51, improving 


upon the design and supplying it 
one complete box. It’s powerful, 
extremely quick, and very sturdy. 
Thanks to the Explorer pHAT 
motor controller, it’s also very 
flexible and can be modified to 
any of your requirements. 


While not a very mobile robot, the MeArm isa 
robot nonetheless, albeit more like one you’d 
find in a Peugeot factory signing Picasso cars. One 
of the coolest things about the project is that it 
comes with a very neat joypad 
setup that fits on top of the 

Pi and controls the arm. 
With a bit of hacking, you _Ao 
can probably repurpose it 

for something else as well. 


( 


——— 


While a lot of Raspberry Pi robot 
kits have an educational aspect to 
them, the GoPiGo goes one step 
further by not only offering an 
easy-to-use series of base kits for 
individuals, but also special kits 
with enough robots for an entire 
classroom. They’ 1] even help you get 
the right educational information. 


This very simple Pi robot looks like 
a Space Shuttle (hence the name 
STS, which was used for Space 
Shuttle mission numbers), giving 
it immediate cool factor. It’s 

a simple build with not much 
ability to be developed further 

as easily as other kits, but it’s 
ereat for beginners and especially 
younger makers. 
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Want to skip 
the kits and 
build a robot 
from scratch? 
Check out 
issue 51 of 
The MagPi for 
tips on what 
you need to 
make your 
own robo- 
companion: 
magpi.cc/51 


This great kit lets you control 
a robot out-of-the-box from 
an Android phone or browser. 
The camera can even be tilted 
and panned to look 
around. The kit is 
aimed at beginners 
and uses a webcam 
rather than the Pi 
Camera Module. 


DiddyBorg v2 


Serious robotics 


This beast of a kit from the robotics whizzes 

at PiBorg is powerful, sturdy, and endlessly 
upgradeable. It’s everything you’d want from a 
robot kit that you plan to use as a test platform, or 
as the base of a bigger, meaner build. There’s even 
a faster version called the Red Edition. 
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Maker 
Says 
28 tiny 

RGB LED 

pixels in a 


Single row 
Pimoroni 


BLINKT! 
Equipped with 
eight larger 
RGB LEDs, the 
original Blinkt! 
has a female 
header to fit 
onto the GPIO. 


magpi.cc/tnbkRL 


LED SHIM 


LED SHIM 
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LED SHIM 


This slimline LED strip could give your Pi the (illuminated) edge, 


as Phil King discovers 


fter upping the pixel count 
on its Unicorn HAT and 
Scroll pHAT, Pimoroni 

has done a similar trick for its 
Blinkt! LED strip, but this time it 
comes in super-slim SHIM form. 
Packing 28 tiny RGB pixels — about 


half the size of the Pi’s own status 
LEDs — the LED SHIM simply 

slips onto the GPIO pins with no 
soldering required. The ‘friction 
fit’? keeps it in place, even when 
turned upside down. While it 
worked fine on most Pi boards we 
tried, we did have an issue with a 
poor pin connection on one Pi that 
resulted in an I/O error. A bit of 
jiggling usually fixes the issue but 
if not, there’s always the option of 
soldering the SHIM to the GPIO or 
adding a female header. 
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Ata mere 0.8mm thick, the 
SHIM leaves plenty of room on top 
to add a HAT or pHAT. And since 
it only uses two P’C pins, there 
should be no pin conflict issues. 
The LED strip protrudes from the 
edge so it’s still perfectly visible 


The SHIM leaves plenty of room 
on top to add a HAT or pHAT 


with another board on top; the 
only downside is that you might 
have trouble fitting the Pi in a case. 


Bright and beautiful 


Arranged in a single row, and 
driven by the same LED matrix 
chip used on the Scroll pHAT 
HD, the 28 LED pixels are tiny 
but bright. A one-line installer 
command adds the software 
library and a host of examples 
(magpi.cc/AoDrqc). The latter 
demonstrate numerous possible 


use-cases — such as a VU meter, 
Twitter status, and data display 
— as well as some impressive 
animated effects. 

There are also some examples 
of using the SHIM with other 
boards such as the Enviro pHAT - 
for which there’s a colour-coded 
direction meter and a spirit level. 

Coding it is similar to on the 
Blinkt!, using a ‘set’ function to 
select a pixel’s RGB shade, thena 
‘show’ function to light it. So it’s 
simple to start creating your own 
lighting effects. 


fast word 


Ideal for a status display, or 
some cool lighting effects on 
the edge of your Pi, this super- 


slim SHIM has numerous 
possible uses and can work 
with add-on boards on top. 
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CoderDojo 


Canlstarta 
CoderDojo club 
in my local area? 


CoderDojo is a global network of free, volunteer-led, project-based 
programming clubs for children aged 7-17. Dojos are championed by 
individuals all around the world who are passionate about giving young 

people the opportunity to learn to code. 


Incredibly 
rewarding experience 


“| started a Dojo to give my kids a place to meet other children also 
interested in programming and making games. | get to see them 
making new friends, learning from one other, and they loved it. 
Realising how | had created such a wonderful place for children has 
ignited a spark in me.’ 

- Maroes, CoderDojo NL 


Start your own club. Join us at CoderDojo.com 


The CoderDojo Foundation is Irish Registered Charity (524255) CHY20812 . 
and Is part of the Raspberry Pi Foundation, UK registered charity 1129409 eae eS Raspberry PI 


MAKER ESSENTIALS 


£5-£20 / $7-27 


Waker 
says 


Components 


and useful 
bits for 
everyday 
electronics 
and tech 


projects 
Pimoroni 


MAKER ESSENTIALS 


CAMJAM 
EDUKIT #2 


CamJam Edukit 
#2 comes 

with a larger 
breadboard, a 
range of LED 
lights and 
sensors, and 

an online set 

of detailed 
worksheets. 


> 
~ 


£8/S11 
magpi.cc/IBortt 
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A selection of neatly packaged parts for makers 


ne of the coolest 
things about coding 
with a Raspberry 
Pi is its integration with 
electronic components. 

Every maker starts out by 
discovering how to set up the GPIO 
pins to a breadboard, and create 
simple circuits with LED lights, 
resistors, and switches. Typically 
the next step is building and 
controlling a robot from simple 
motors and wheels. 

There’s no shortage of starter 
euides on how to blink an LED with 
a Raspberry Pi, or use buttons to 
interact with code. But it’s often 
weirdly confusing for a beginner to 
eet hold of components to go with 
online tutorials. 

Which is where Pimoroni 
hopes its Maker Essentials kits 
will step in. This collection of 
low-cost components offers a 
neat and simple way to get basic 
equipment without having to buy 
packs of parts from random eBay 
or Amazon sellers. 


There are five different packs 
available: LEDs & Resistors (£5.50), 
Various Headers (£5.50), Mini 
Breadboard & Jumpy Jerky (£9.20), 
Switches & Potentiometers (£7.26), 
and Micro-motors and Grippy 
Wheels (£22). 


Quality components 

Each pack is sealed and contains a 
selection of the appropriate parts. 
Quality is high across the board, 
although some packs seem to make 
more sense than others to us. 

The collection of LEDs & 
Resistors is valuable for any 
beginner. The Mini Breadboard & 
Jumper Jerky would be a good pack, 
but one larger breadboard would be 
infinitely more practical than two 
mini boards. 

The Switches & Potentiometers 
is a useful pack of parts, but 
does anybody really need the 48 
headers in the Various Headers 
pack? (We’re sure folks will get in 
touch saying they can never have 
enough headers.) 


PIMORONI 


Maker Essentials 


LEDs & Resistors 


Perhaps the most interesting 
pack is Micro-motors & Grippy 
Wheels, which offers a neat path 
to a micro robotics kit. The motors 
and wheels are dinky, but you'll 
need a motor controller (which 
you could get for the same price 
included in some other kits). 

We couldn’t find any online 
instructions for the kits. Given the 
simple nature of the components, 
that’s not a major issue: there’s 
no shortage of tutorials for any of 
them. Even so, beginners will be 
better served with a package that 
combines parts with instructions. 


fast word 


These are neat packs of high- 
quality components that serve 
a simple purpose, but do it well. 


Total beginners should look to 
more comprehensive kits with 
project instructions, though. 
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YOUTUBE 
VIDEOS 


The best Python YouTube sites 
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RASPBERRY Pl 


The Official Raspberry Pi channel is 
packed with resources for learning 
to code, and almost all of them 
feature Python. You'll also find 
advice on setting up a Raspberry Pi, 
plus how to make awesome things 
with Raspberry Pi, Python, and 
electronics. Be sure to subscribe! 
youtu.be/QAHJVez2jq_E 
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GEEK GURL DIARIES 


This fantastic website offers a crash 
course on computer science and 
programming by none other than 
Code Club's Carrie Anne Philbin. 

It covers a range of boards and 
technologies, but be sure to take a 
look at the Raspberry Pi tutorials. 
youtu.be/bZwubV-m9JM 
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LEARN PYTHON 


Amore advanced collection of video 
tutorials put together by Free Code 
Camp. This comprehensive course 
isn't Raspberry Pi specific, but covers 
everything from getting started with 
strings all the way up to objects 

and inheritance. 
youtu.be/rfscVSovtbw 
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New to Raspberry Pie Want your 
children to learn coding and have 
fun connecting up lights, sensors, 
or even marshmallows? Or even 
use the Pi to make a dedicated 
device? You’ve come the right 
place. Philbin is a technology 
educator with plenty of experience 
of bringing alive the Pi’s 
possibilities for a young audience. 
After setting up the Pi, and 
learning some command-line 
basics, readers get to try using the 
Scratch programming language 
to animate a monkey sprite, then 
Start building a role-playing 
game, before diving into turtle 
eraphics to make shapes with 
both Scratch and Python. Sonic 
Pi continues the coding — making 


music with Ruby code. Throughout 
these divergent adventures, 
additional notes, definitions, and 


tips and tricks combine with the Author: 
lessons to more broadly educate Carrie Anne Philbin 
new programmers. estan 
The last chapters are on oa. 
hardware: using the GPIO with £20.99 
those sensors and marshmallows, ISBN: 


978-1119269069 
magpi.cc/2zt24rO 


and building a Pi jukebox. 
Readers who already have the 
second edition (see The MagPi 
#32) will want to know what’s 
new — awhole extra chapter on 
experimenting with cameras, and 
expanding your Pi’s capabilities 
with add-on HATs - but won’t 
need any persuasion to buy extra 
copies as Christmas presents for 
young relatives! 


Carrie : 
Ann 
© Philbin 


WILEY 


TEACH YOUR KIDS TO CODE 


Dr Payne promises “programming 
SO easy a parent can do it!” Starting 
with turtle graphics, the reader is 
drawn in, and Python seems natural, 
easy, yet still a thing of wonder. 
Learners are encouraged 
to experiment, rather than 
overloaded with details of how 
and why — but where details are 
necessary, such as number types 
and operators, they are introduced. 
As concepts are brought into 
play, we feed them into turtle 
eraphics — so conditionals lead 
to fractal spirals, and user input 
selects the shape drawn. 
Programming challenges at 
the end of each chapter — turning 
the High Card game into War, or 
adding sound effects to the Pong 
game — steer further learning. 


Aimed at children aged nine 
and up, there’s enough here 
for everyone — parents can take 
younger children through some of 


the projects, and teens shouldn’t oolaid 
ears a f Bryson Payne 
Seer re | Publisher: 
Payne has the balance right No Starch 
between giving enough in plentiful, _ Price: 
fun projects to keep interest, and £19.99 
ISBN: 


introducing programming concepts 
to build real understanding almost 
by osmosis. 

Python and Pygame installation 
are banished to an appendix, where 
you’ ll also find instructions on 
creating your own modules! And 
once more, delightful illustrations 
by Miran Lipovaca lift an already 
excellent No Starch book to another | 
level. Strongly recommended for 
learners of all ages. 


978-1593276140 
magpi.cc/TYkZLo 
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LEARN PYTHON WITH RASPBERRY PI 


PROGRAMMING 
THE RASPBERRY PI 


This could be the perfect 
introductory programming book to 
give to someone who’s just got a 
Raspberry Pi for Christmas. 

With no wasted words, Monk 
introduces the Pi and its operating 
system, then teaches both Python 
and using Python with the Pi, ina 
direct and easily absorbed text that 
harks back to the best beginner 
cuides of the 8-bit era. 

Skip the first two dozen pages 
if you are not new to the Pi, 
and dive into Python with an 
introduction that — through 
well-chosen examples, such as 
a dice rolling simulation — will 
have you learning conditionals, 
control flow, and comparison 
operators before you know it. 
Next, Hangman introduces 


functions, as well as strings, Author: 
lists, and dictionaries. OOP is ea 
touched on with a temperature ana 
Tab Electronics 
converter, then file handling and Price: 
GUI programming (with Tkinter) £11.64 / $15 
ISBN: 


through building on the earlier 
code examples. The Pygame 
chapter makes use of many of 
the techniques learned, then 
moves on to refactoring. 


978-1259587405 
magpi.cc/224fOlh 


The same concise style is Programming 
used to cover the Pi hardware : e Raspberry Pj 
for the rest of the book: with papeated 


GPIO pins, breadboard 
prototyping, connecting an 
Arduino, then a range of 
sample projects culminating 
in a Raspberry Pi robot. 
Unreservedly recommended 
for confident beginners of 
all ages. 


© El simon Monk 


HEAD FIRST PYTHON 


Whether or not you like the quirky, 
visual style of O’Reilly’s Head 
First books, this is an excellent 
introduction to Python, well 
written and well paced. Aimed 

at those with at least a little 
coding experience in another 
language, Paul Barry’s text starts 
iconoclastically by sidestepping 
Hello World and diving into a 
more in-depth first program, 
bringing in the list data structure, 
importing from the standard 
library, and introducing the 
powerful in operator. 

The data-first approach, with 
lists, then dictionaries, tuples, 
and sets, is a firmer foundation 
than starting with control flows. 
Functions follow, and making 
your own modules, which you 
then install in the cloud at 
PythonAnywhere, to support the 
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web app you write with Flask. 


Difficult subjects like decorators, Author: 
comprehensions, and generators Paul Barry 
are painlessly introduced, as our niitninina 
app is constantly refactored, — 
and communicating with an SQL oa) a 
database is carefully taught. ISBN: 


PEP8 gets an early mention, but 
otherwise testing 
is left. Nor is there 
anything on Jupyter 
or doing data 
science, for example, 
but this is a book 
that teaches a lot, 
very quickly, and 
confident learners — 
who find other i 
introductory books 
too slow- paced will 
eet a head start in 
Python with this = 
Head First guide. Siig 


978-1491919538 
magpi.cc/2nfiscb 


A Brain-Friendly Guide 


Head Fipgt 


Move your custom 
SDP to the Web 
« 


Share your Code with 
the world on PyP] 


Second Edition 


INTERACTIVE 
WEBSITES 


Python web resources 


ene 
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RASPBERRY PI 


The Raspberry Pi Education section 
on the official website should be 
your first port of call when learning 
anything with a Raspberry Pi, and 
Python is no exception. Here you'll 
find tutorials, blog posts, and 
education resources. Sign up to 
the Education Newsletter while 
you're there. 

rpf.io/ education 


FUTURE LEARN 


Raspberry Pi has teamed up with 
FutureLearn to provide interactive 
courses, most of which are in 
Python (and there's a great Scratch 
to Python course). The courses 

are structured to last three to four 
weeks and only require a few hours 
a week to learn. 
rpf.io/online-training 


Learn Python 


meat 


10 Hours 


CODECADEMY 


One of the most popular coding 
sites around is Codecademy. Here 
you sign up and learn coding 
techniques in an interactive web 
environment. It’s based ona 
‘gamification’ approach, so you 
get points and win awards for 
completing code missions. 
magpi.cc/FUhUGy 
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£12.99 


200 pages of 


RASPBERRY PI 


PROJECTS BOOK 


Ce MOLUMES 


Amazing hacking and making projects 
from the makers of MagPi magazine 
Inside: 
® How to get started coding on Raspberry Pi 
® The most inspirational community projects 
® Essential tutorials, guides, and ideas 


@® Expert reviews and buying advice 


Of le ® 
Ce magpi.cc/store 


plus all good newsagents and: 


WHSmith BARNES&NOBLE 


9 Available on the GET IT ON 


App Store >> Google Play 
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MAKER FAIRE 


We head to Tokyo to see what the Japanese Raspberry Pi 
community has been getting up to lately 


hen we say the Raspberry Pi is used all 

around the globe, we truly mean it. There 

are thousands of Code Clubs and CoderDojos 
spread across the world and you’|l find Raspberry Pis 
everywhere on (and in some cases orbiting around) the 
Earth. The Japanese Raspberry Pi community is huge 
and, as we found out during our visit to Tokyo for Maker 
Faire, incredibly inventive. 
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Stalls ranged from the 
very flashy to the very DIY 
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Robots wandering the 
show floor were common 


This custom 
pinball machine 
was made up of 
old computer parts 


Korean 
projects also 
made an 
appearance, such 
as this cute line- 
following robot 
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Japanese pop culture 
was well represented 
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There 
were amazing We saw more computer 
selfie spots set vision projects than ever 


up everywhere 


Baking is 
a classic form of 
making, and we 
especially loved 
these Raspberry 
Pi-shaped cookies 
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Flipping up the piano, you 


could see how it works 


Brother was showing off projects 
using conductive thread, like this piano 


Light-up balls for robot 
shooting helped with aiming 


LEGO was 
rare here, but used 
very well with Pi 


One of 
our favourite 
categories at 
Maker Faires is 
the agricultural 
products, and 
Tokyo did 
not disappoint 


raspberrypi.org/magpi September 2018 MagPi | 389 


yp 


AND 


FEATURE 


In Tokyo’s Electric Town, you can 
find a Piin almost every store 
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Components are 
neatly arranged in 
every store, filling 
up as much space 
as possible 


An old 
favourite of ours, 
Rapiro is still 
alive and kicking 
and you can 
buy them from 
Switch Science 


kihabara is one of the many areas that make 

up Tokyo, a loosely defined series of streets 

and shops in a sea of skyscrapers. Informally 
known as Electric Town, it’s more famous these days to 
people in the West as a centre of Japanese pop culture 
and nerd stuff. But among the Animate and Super 
Potato stores, maid cafes, and UFO arcades still lie the 
electronics shops of the past. 

Masafumi Ohta from the Japanese Raspberry Pi User 
Group showed us around Akihabara (or Akiba), pointing 
out all the interesting electronics shops. Row upon row 
of various components and electronics were lining the 
cramped shelves of the small stores, including sections 
dedicated to newer maker gear like the Raspberry Pi, 
Ichigo Jam, and Arduino. “You can also buy all of this 
online,” he assured us. 


Make the switch 

Earlier in the day we had taken a trip to Switch Science, 
an online supplier of Raspberry Pi and other maker 
goods in Japan. In Shinjuku, another area of Tokyo, 
Switch Science takes up a couple of offices where they 
ship out orders, make their own products, and create 
Japanese educational materials for young makers. 

“We saw a growing desire for educational materials 
among makers,” Yoshichika Yasui of Switch Science 
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One part store, one part 

~~ makerspace, you could 
buy electronics and 

maker projects here 


told us. The office was a manic flurry of motion as 
orders were packed to be sent all over Japan, and even 
internationally. 


Education spaces 
Back in Akiba, Masafumi-san finally brought us to 
PCN’s flagship location. One part store and one part 
makerspace, here you could buy the ever popular Ichigo 
Jam. It’s a low-power, single-board PC in a similar 
vein to Raspberry Pi, albeit with a more basic control 
method. It uses a BASIC-esque programming interface, 
and school classes were free to come down and learn 
computing using it — in fact as we were talking, a 
retired teacher entered the store and proceeded to tell 
us how important this kind of education was. 

It’s also a general makerspace for people wanting 
to work on their projects in a communal setting — and 
there are plenty of projects to buy in the store and 
steps away in other electronics stores in the area. It’s 
a hugely popular resource for the local community it 
seems, and really highlights one of the general themes 
we saw while with the Tokyo maker community: 
everyone enjoys helping each other, and wants to make 
sure there’s a space to do so. 


The office was very busy making 
sure orders were shipped 
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THE MONTH INRASPBERRY Pl QQ Til 


CROWDFUND Bee 
THI S : Raspberry Pi projects you Here are some other great 
m can crowdfund this month things we saw this month 


WHERE'S AI WALLY? 


youtu.be/-i7HMPpxB-Y — 


AIR MONITOR & 
MULTIMEDIA KITS 


Another innovative product idea from Nanomesher, 
this time a multipurpose case and Pi kit that can be 
used as a weather Station, video streamer, and music 
player depending on which version you get. It uses 
the great HATs already available from Nanomesher 
and lets you build them all into a custom-made Ever have to worry about cheating in your table football 
enclosure that offers more functionality than games? This ingenious Raspberry Pi system keeps 
previous Nanomesher kits. track of the score digitally, so no one can sneakily move 
counters across during the heat of a showdown in the 
centre of the table. 


magpi.cc/Dq@Lec 


Protective Case for 
Raspberry Pi & Camera 


kek.st/2Mdm7TG 


PISHELL 


The PiShell seeks to fix an issue that you may find 
with many Raspberry Pi cases — while they’re great at 


protecting the Pi, you can’t always access the camera 


magpi.cc/wyQLij " 
porter eventine GIO pms, Ine Pisivellcemesin three se # aL 


parts: a base to set the Pi on; an intermediate step that = 
lets you plug in the camera, use the DSI display port, 
and access the GPIO pins; and an easily removable lid 
that also has hole for the camera to peep through. It’s 
a great idea, and SB Components is well known for its 
excellent-quality gear. 


aL. 
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EVENT CALENDAR 


Find out what community-organised, Raspberry 
Pi-themed events are happening near you... 


ROCHESTER = - ? eee 
RASPBERRY JAM’ @~— “ SR, we 


4 SRVEF RASPBERRY PI JAM % 


8 


Want a Raspberry Jam in your 
area? Want to start one? Email 
Ben Nuttall to find out more: 


ben@raspberrypi.org 


J lee DALLAS YOUNG 
ae, MAKERS CLUB 
a 
io 
5-6) Me GUI AR le WIEINIES 

RASPBERRY JAM FEN JAM CORNWALL TECH JAM 
CAMBRIDGE When: Sunday 23 September When: Saturday 8 September 
When: Saturday 15 September Where: Bluntisham Village Where: Bodmin Library, 
Where: Sancton Wood School, Hall, Bluntisham, UK Bodmin, UK 

Cambridge, UK fenjam.org cornwalltechjam.uk 
magpi.cc/WxgdfB The first Fen Jam, with Learn about programming on 
Not the usual CamJam, buta plenty of exciting things platforms including Arduino 
new Raspberry Jam run by the planned for fans of and Raspberry Pi, in a whole 
Cambridge Technology Academy. Raspberry P1. variety of languages. 
ROCHESTER RASPBERRY SRVEF RASPBERRY PI JAM HULL RASPBERRY 
PI JAM When: Saturday 29 September PI JAM 
When: Saturday 22 September Where: BRITA, San Ramon, When: Saturday 15 September 
Where: University of Rochester, CA, USA Where: University of Hull, 

Rochester, NY, USA magpi.cc/TycEuL Hull, UK 
magpi.cc/niySeR Run by (a different) magpi.cc/gRYMsi 
Although aimed at youngsters, Imagineering team and Share, learn, and tinker with 
anyone with an interest in providing students with the digital making projects using 
programming is welcome. technical expertise they need. Raspberry P1. 


MagPi September 2018 raspberrypi.org/magpi 


WE'VE SOME OF 
THE AREAS 
CAN YOU HELP OUT? 
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5 CORNWALL TECH JAM 


Every Raspberry Jam is entitled to apply for a 
Jam starter kit, which includes magazine issues, 
printed worksheets, stickers, flyers, and more. 
Get the guidebook here: magpi.cc/2qSDHfQ 


acer RASPBERRY JAM ADVICE 
RASPBERRY JAM 
When: Saturday 8 September 
Teaching, Belfast, UK PROMO I ING YOUR la ae ( Ak 
magpi.cc/yNUGdg 
coding, electronics, and generally radius of the CamJam venue, and managed 
having fun making! to find someone who would attend free of 
DALLAS YOUNG us and the attendees, and we know we can 
MAKERS CLUB build food etc. into the ticket price. 
Where: J. Erik Jonsson Central Cambridge Raspberry Jam 
Library, Dallas, TX, USA 
Build a robot, make a computer, 
and create comics and books at 


Where: School of Maths and Physics 

This free event involves tinkering, We searched online for caterers in a 30-mile 
charge. The venue is very convenient, for 

When: Saturday 22 September Michael Horne 

dallasyoungmakers.org 

the Dallas Young Makers Club. 
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LETTERS 


SUBSCRIPTIONS 


At the beginning of the year I had 
to cancel my subscription as I 
couldn’t quite afford it. However, 
I’m now able to subscribe again! I 
couldn’t find your three- and six- 
month subscriptions though; are 
they no longer available? 

Also, I was on a twelve-month 
subscription before and got my 
free Pi Zero W bundle with that, 
and I was wondering if I would get 
another bundle if I re-subscribed? 
I’d understand if it was just one 
per customer, though. 

Finally, do you get anything 
free with the rolling subscription: 
Lin 


That’s correct, we currently 
only offer the monthly rolling 
subscription and the year-long 


TOYS TO LIFE 


I was wondering if it was 
possible to use a Raspberry 
Pi to ‘hack’ a toy so that you 
can then control it or make it 
more functional with the Pi? 
There are some with simple 


electronics that must be 
controllable with a Pi, and even 
then I do wonder if I could just 
use the empty space in a toy to 
add electronics. 

Has anyone ever done this? 
Louis T 


There are a few limitations, but 
we’ve seen plenty of people 
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do something like this witha 
wide variety of toys and the 

like. Usually the limitations 
involve whether or not you can 
actually interface with parts of 
the device (and some people just 
tend to replace them, such as old 
screens, anyway). If you can find 
space for parts, however, you can 
do whatever you want. 

Some of our favourites include 
turning a toy car dashboard into 
a fully functional Out Run arcade 
machine, and turning a toucan 
toy for very small kids into a 
Google voice assistant. 


subscription. Any savings 

you’d have got with three or six 
months you get with the monthly 
subscription, and you can cancel 
that at any time! It also means you 
never miss an issue. 

As for free stuff, while you don’t 
get any special extra bundles like 
with the year-long sub, you still 
get all the free stuff that you’d get 
with the magazines anyway — such 
as any kits or posters we include in 
future issues. 

Also, the Pi Zero W bundle is not 
once per lifetime! Every time you 
take out or renew a twelve-month 
sub, you’ ll get the bundle we offer. 
That may change at some point 
down the line, but currently there 
is no end date on that. 

Hope this helps! 


. 
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The Tomy Turnin’ Turbo Dashboard arcade 
mod is one of our favourite recent Pi projects 
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YOUR LETTERS 


and then install anything. Make sure to use this exact 
series of commands: 


FROM THE FORUM: 


sudo -i 

echo "deb http://goofy.zamia.org/repo- 
ai/raspbian/stretch/armhf/ ./" >/etc/apt/ 
sources.list.d/zamia-ai.list 

wget -qO - http://goofy.zamia.org/repo-ai/ 
raspbian/stretch/armhf/bofh.asc | sudo apt- 


OFFLINE VOICE 


The Raspberry Pi Forum is a hotbed of conversations hoy sue 
and problem-solving for the community — join in via 
raspberrypi.org/forums If you’re still having some problems, double- 


check your internet connection or use a fresh install 
’m stuck trying toaddthe __ try to install the software it says of Raspbian. 


repository for the Zamia ‘not found’. 
speech stuff from the new Please help! 
MagPi [Ed’s note: issue 72] and Lee WRITE TO US 
can’t get it to work. Have you got something you'd like to say? 
I’ve typed the commands in You need to make sure you start 
; ; ; ; Get in touch via magpi@raspberrypi.org or on The MagPi 
and when I press ENTER it says the entire sequence with sudo -1i 


section of the forum at: raspberrypi.org/forums 
OK, but when I do an update and before trying to add the repository 


Connecting Raspberry Pi 
to FPGA through USB 


— 


a <S 


— 


—— > =. ae 
with FMC Daca = 


oon 


¢ CON-FMC™ supports USB 3.0/2.0. 
¢ CON-FMC™ supports Ubuntu, CentOS, and Raspbian. 
¢ CON-FMC™ supports C/C++ API such as BfmRead() and BfmWrite(). ~—— 
¢ CON-FMC™ supports off-the-shelf FPGA board with FMC connector. 

¢ CON-FMC™ supports FIFO interface and AMBA AXI/AHB/APB buses. 


¢ CON-FMC™ supports CPU-to-FPGA offloading. - UJ T U Re FE 


For additional information contact at contact@future-ds.com or os 
visit www.future-ds.com/CON-FMC Design Systems 


raspberrypi.org/magpi September 2018 MagPi | 95 


7 he | 


CAN YOU HELP INSPIRE © 
THE NEXT GENERATION 


OF CODERS? 


Code Club is a network of volunteers and 
educators who run free coding clubs for 
young people aged 9-13. 


ra! To find out more, join us at 


Code Club is part of the Raspberry Pi Foundation. Registered Charity Number 1129409 C5 


WIN! GP Fi Supply 


NETWORK SECURITY BOAES! 


We reviewed the Pi-hole in issue 71 of The MagPi and 


gave it a four-star rating due to its ability to handle 
even the heaviest ad-laden websites, so it can 
keep your network very secure from bad ads. 


“Pi-hole is a device that allows 
you to block all of those annoying 
internet advertisements on any 
device and even in apps” 
Pi Supply 


has five of the 


Doxes to give 
away, 


Enter now at magpi.cc/win magpi.ce/Ze0TqW 


Terms & Conditions 

Competition opens on 29 August 2018 and closes on 26 September 2018. Prize is offered to participants worldwide aged 13 or over, except employees of the 
Raspberry Pi Foundation, the prize supplier, their families or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering 
the competition, the winner consents to any publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from 
The MagPi magazine. We don't like spam: participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and 
no cash alternative will be offered. Winners will be contacted by email to arrange delivery. Any winners who have not responded 60 days after the initial email is sent 
will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, or associated with, Instagram or Facebook. 
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Column THE FINAL WoRD 


SIMON LONG 


Simon Long is a software engineer working for Raspberry Pi, 
responsible for the Raspberry Pi Desktop on both Raspbian 
and Debian. 


THE LAST 


we 10 PERCENT 
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t was almost exactly four years ago 

when I was offered the chance to work 

at Raspberry Pi. I knew all the team very 
well, but I’d had hardly any involvement with the 
Pi itself, and wasn’t all that sure what they would 
want me to do; at that time, I was working as the 
manager of a software team, with no experience of 
hardware design. 

Fortunately, this was when software had started 
to move up the list of priorities at Raspberry Pi. 
Eben and I sat down on my first day and played with 
the vanilla LXDE desktop environment in Raspbian 
for 15 minutes or so, and he then asked me the 
fateful question: “So — do you think you can make 
it better?” 

With rather more confidence than I felt, I replied 
“of course!” I then spent the next week wondering 
just how long it was going to take before I was found 
out to be an impostor and shown the door. 


Ul experience 

To be fair, user interface design was something of 
which I had a lot of experience — I spent the first ten 
years of my career designing and implementing the 
user interfaces for a wide range of products, from 
mobile phones to medical equipment, so 1 knew 
what a good user interface was like. I could even 

see what changes needed to be made to transform 
the LXDE environment into one. But I didn’t have a 
clue how to do it — I’d barely used Linux, never mind 
programmed for it... 

As I said above, that was four years ago, and I’ve 
been hacking the Pi desktop about from that day on. 
Not all the changes I’ve made have been popular 
with everyone, but I think most people who use the 
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Simon Long talks about his experience of revamping the Raspberry Pi Desktop 


desktop feel it has improved over that time. My one 
overriding aim has been to try to make the Pi desktop 
into a product that I actually want to use myself; one 
that takes the good user interface design principles 
which we are used to in environments like macOS 
and Windows -— ideas like consistency, attractive 


So — do you think you 
can make it better? 


fonts and icons, intuitive operation, everything 
behaving the way you expect without having to 
read the instructions — and sculpting the interface 
around them. 


Final polish 

In my experience, the main difference between 

the Linux desktop environment and those of its 
commercial competitors is the last 10%; the polishing 
you do once everything works. It’s not easy making 
something that works, and a lot of people, once they 
have created something and got it working, leave it 
and move onto creating something else. I’m really 
not great at creating things from scratch — and have 
nothing but admiration for those who are — but what 
I do enjoy doing is adding that last 10%; going from 
something that works, to something that works well 
and is a pleasure to use. 

Being at Raspberry Pi means I get to do that every 
day when I come to work. Every time I see a photo of 
a Pi running at a Jam, or in aclassroom, anywhere in 
the world, and it’s using my desktop — the thrill from 
that never goes away. 
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CDP Studio is a development platform for industrial control systems, now coming with a free 

version for non-commercial use. The system can run on a Raspberry Pi, supports C++, open source 
libraries and has a large feature toolbox including GPIO, I2C and MQTT. Its built in GUI design tool 
and features lets you code less and do more. 


Free download on 


CDP Technologies AS 
Nedre Strandgate 29 

P.O. Box 144 

NO-6001 Alesund, Norway 


Tel: +47 990 80 900 
info@cdptech.com 
www.cdpstudio.com 


CDPStuUdio 


THE Official 
RASPBERRY PI 
EGINNER’S BOOK 


THE EASY WAY! 


Pi Zero W computer 


Official case with three covers 
USB and HDMI adapters 

8GB microSD card 

116-page beginner’s book 
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